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PROFESSIONAL CONTROL SYSTEM DEVELOPMENT TOOL 


Home projects made easy. 


CDP Studio, a great software development tool for your home projects. Build 
systems for Raspberry Pi, use C++ or NoCode programming, open source libraries, 
(10) axe) it al=s ole). @rs10] 0) ole) an Ke) aC] =| OMm VAGHE\Y/ LO I ©) = Om OW] ale aa le)a-mm @rg-t-1(-Ol-t-[ULCIRO| MU Si-18 
interfaces. Built for industrial control system development, FREE for home projects. 


cdpstudio.com 
Tel: +47 990 80 900 « info@cdptech.com ; 
CDP Technologies AS // Hundsvzergata 8, 6008 Alesund, Norway CDP Studio 


WELCOME 
to The MagP1 107 


aspberry Pi is an amazing computer that enables you to 
explore computing from a whole different perspective. 
It enables you to check out the technology, right down to 
the metal. 

Become a Raspberry Pi Genius (page 32) is this month's lead feature, 
and is all about fixing the problems that trip up newcomers. Nobody 
likes to think of themselves as a ‘genius’, but understanding how a 
computer works is a form of magic all in itself. 

Rob has got more Big Builds this month. Only now they’ re Handheld 
Builds (page 72). These projects are big in scope, small in stature. Tiny 
arcade machines, laptop computers, and digital cameras. They are 
amazing projects that don’t need a massive garage to build. 

Speaking of arcades, there was a collective intake of breath when 
K.G submitted the photos of their arcade build with the decals affixed 
(page 42). The result looks nothing short of incredible. 

There are a lot of things that ‘wow’ in this edition of The MagPi. | 
hope you enjoy it as much as us. 
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Lucy Is editor of 

The MagPi and 
magically transforms 
coffee into code. 
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Subscribe to The MagPi, HackSpace magazine, or Custom PC. Your first three Issues for £10, then our great value rolling subscription 
afterwards. Includes a free voucher for one of five fantastic books at store.rpipress.cc/collections/latest-bookazines 
UK only. Free delivery on everything. 
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Bluebot Shoal Fish Robot 


RUHAcam 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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for your Raspberry Pi 4 
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Mini OLED screen 
& programmable 
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| Integrated 1-watt 
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5-hour internal 
battery 
0 FF, Integrated heat 
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UPS-style soft shutdown 
system prevents SD 
card corruption 


USB-C Power 
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at 15V for faster 
battery charging 
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Full access to Raspberry Pi’s 
GPIO pins & ports 
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pi-top [4] DIY Edition Is the only Raspberry By installing your Raspberry Pi 4 into pi-top 

Pi 4 case with an inbuilt battery and power IDI AM oli dle) apmienisue| ove] cele(-emlalcomaal-melialaalela= 
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Raspberry Pi made simple, robust and modular. pi-top.com 
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Raspberry P1 PoE+ 
HAT announced 


Power your Raspberry Pi 4 straight from the Ethernet connection 


A Raspberry Pi PoE+ HAT 
connects directly to 
Raspberry Pi via the 
GPIO pins 


generation of its Power over Ethernet 
(PoE) HAT. 

Power over Ethernet is a technology that enables 
you to power a device from an Ethernet connection 
(providing the Ethernet network has power- 
sourcing technology). 

Raspberry Pi PoOE+ HAT (magpi.cc/poet) delivers 
more power, implementing the 802.3at PoE+ 
Standard; and it runs cooler, thanks to various 
design improvements. “Best of all, we’ve been able 
to keep the original affordable price of $20 [£18 in 
the UK],” says Eben Upton, Raspberry Pi creator 
and founder of the Raspberry Pi Foundation. 


- aspberry Pi has announced the next 


More power 

The original PoE HAT could deliver a guaranteed 
minimum of 13 W to a Raspberry Pi. Enough to power 
Raspberry Pi 4 at maximum load, but not quite 
enough to also power the hungriest USB peripherals. 
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M Raspberry Pi PoE+ HAT 
delivers more power... and 
it runs cooler @ 


The PoE+ HAT implements the newer 802.3at 
standard. When used with a compatible switch or 
injector, it can deliver up to 25 W. 

“To reduce heat dissipation, we replaced the diode 
rectifier with an ‘ideal diode’ rectifier, in the form 
of a Microchip PD70224ILQ device,” explains Eben. 

“For the PoE+ HAT, our friends at Bourns 
have provided us with a shiny new toy: a planar 
transformer.” You can learn more about these 
technologies in Eben’s blog post on Raspberry Pi’s 
website (magpi.cc/announcingpoet). 

Raspberry Pi PoE+ HAT is available now from 
SB Components, OKdo, and other Raspberry Pi 
resellers (magpi.cc/poet+). 
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RP2040 on 
sale now at Sl 


Buy the heart of Raspberry Pi Pico for a buck 


Approved Resellers in single-unit 
quantities, allowing you to build your 
projects and products on Raspberry Silicon. 
Raspberry Pi Pico was the board that introduced 
RP2040 to the world (magpi.cc/pico). “RP2040 is 
our idea of the perfect mid-range microcontroller, 
based on years of using other vendors’ devices in 
our own products and projects,” says Eben Upton. 
“The single-unit price of RP2040 is $1, giving 
you a lot of bang for your (literal) buck. We’ re 
still figuring out what reel-scale pricing [bulk 
purchasing] will look like in the autumn, but we 
expect it to be significantly lower than that.” 
Head on over to the R2040 product page 
(magpi.cc/rp2040) to order your first chips. When 
you’ re ready to take your RP2040-based project to 
scale, Raspberry Pi will be waiting for you. Hl 


R P2040 chips are now available from 





A Raspberry Pi 2040: the 
first “Raspberry Silicon" 
microcontroller 


V Raspberry Pi PoE+ HAT 
powers Raspberry Pi via 
the Ethernet connection 
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Epigone 
Drone 


Inspired by NASA's attempt to launch a 
helicopter on Mars, one maker made an Earth- 
bound one of her own, hears Rosie Hattersley 


ike millions of us, in April Avra Saslow 
watched with bated breath as NASA’s 
Perseverance rover touched down on the 
surface of Mars. 

Like most of us, Avra knew all about the other 
eround-breaking feat being trialled alongside 
Perseverance: a helicopter launch called Ingenuity, 
that was to be the first flight on another planet — “a 








Avra Saslow 

fairly lofty goal”, says Avra, since “the atmosphere on 

1 1 d ) 

Reid Mars is 60 times less dense than Earth S. | 
computer science With experience of Raspberry Pi-based creations, 
and geography in Avra was keen to emulate Ingenuity back here on 
Boulder, Colorado, ° ‘ é 
pe vinae hoon earth (magpi.cc/ingenuity). 
snclectronics NASA chose to use open-source products and use 
and Raspberry Pi commercially available parts for its helicopter build. 
WON ManInCClass It just so happened that Avra had recently begun 
speakers for her final ; 
physics project. working at SparkFun, a Colorado-based reseller 
‘ that sells the very same Garmin LIDAR-Lite v3 laser 
instagram.com/ ; eas 
avranator47 altimeter that NASA’s helicopter is based on. “It’s a 


compact optical distance measurement sensor that 
gives the helicopter ‘eyes’ to see how far it hovers 
above ground,” Avra explains. 
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MagPi 


A Garmin LIDAR-Lite v4 LED altimeter 
acts as ‘eyes’ and measures changes 
in the surface elevation 


aKow-\Ve)(ou ol-)1are my) eX-16 Mom tal-melKe)al- a 
rotors, the Raspberry Pi 4, which 
uses NASA's especially written F 
madlantemexele(= mice) mX=l(-)aa\-14aVem allem Kol ol= 
positioned very carefully 





Avra is a big fan of 
Python for citizen 
science projects 


: ta ST he 4 ~* "es a As a keen cyclist, 
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diversity of makers 


Ingenuity's lead 
engineer helped 
Avra complete her 
Sm own version 
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& NASA recognises that Raspberry Pi offers a way 
to “dip your toe in embedded systems,” says 
Avra, and “encourages the idea that Linux can 
run on two planets in the solar system" 








™ NASA posted the Ingenuity helicopter’s open-source autonomous space-flight 
software on GitHub. It was written specifically for use with Raspberry Pl! @ 


& NASA's Ingenuity helicopter, which inspired 
the Epigone, completes its first one-way 
flight on Mars. (Image credit: NASA) 





NASA posted the Ingenuity helicopter’s open- encourages others to explore F’ and the opportunity 
source autonomous space-flight software, written to make use of NASA’s code: magpi.cc/fprime. 
specifically for use with Raspberry Pi, on GitHub. The Epigone Drone is built around Raspberry 
Avra took all this as a sign she “just had to Pi 4 Model B; Garmin’s LIDAR-Lite v4, which 
experiment with the same technology they sent connects to a Qwiic breakout board and has a laser 

Alert! to Mars.” rather than an LED; a battery pack; and a DJI Mini 2 
: drone borrowed from a videographer colleague. 
Drone safety . . 
F Prime and shine Having seen how small the drone was, Avra 
| _ Her plan was to see whether she could get GPS and realised 3D-printing an enclosure case would make 
eae a lidar working within NASA’s framework, “andthen — everything far too heavy. As it was, positioning 
erga nee take the sensors up on a drone and see how it all the Epigone onto its host drone was challenging 
by the Civil Aviation performed in the air.” Helpfully, NASA’s GitHub enough: the drone’s rotors passed worryingly close 
' ideale ants sa . post included a detailed F Prime tutorial based to the project’s Raspberry Pi, even when precisely 
and Model Aircraft Code around Raspberry Pi: magpi.cc/fprimegit. Avra positioned in the centre of the drone’s back. The 
salsa Cl ieee says understanding and using F Prime (F’) was the drone has its own sensors to allow for controlled 
drone regulations in hardest part of her Epigone drone project. “It’s navigation, which meant Avra’s design had to 
Oriel COURIC a beast to take on from an electronics enthusiast diverge from NASA’s and have its lidar ‘eyes’ on its 
magpi.cc/dronecode standpoint,” she says. Even so, she emphatically side rather than underneath. 
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Make a Mars helicopter 


i 


i = i 





0 To emulate Avra's version, you need Raspberry 
Pi 4,a Garmin LIDAR-Lite v4 for telemetry, 

an NMEA GPS receiver, Qwiic breakout board, a 

power pack, and a drone to provide the lift. You 

should closely follow NASA's detailed F’ tutorial 

for Raspberry Pi (magpi.cc/fprimegit). The steps 

assume you have your own drone to power your craft. 






A A Avra's videographer 
colleague lent her the drone 
that enables Epigone to 
achieve lift-off 





F’ GPS Application Diagram - v0.1 





02 NASA explains how to use F’ with Raspberry 
Pi and an NMEA-enabled GPS receiver 
attached to a serial driver (magpi.cc/fprimegps). It 

can read in GPS messages from a UART port, then 
produce events and telemetry through the GPS link. 


cfaml Version= 1.8" encoding= UTF-8" f= 


<foxygen RNGSchemas"file:../xm1/TSF_Component_Schema. rnc 





: : oa 4 These glass speakers, made 
Although her version piggybacks on an existing paler c cal creee 


drone, Avra was amazed when her Epigone were Avra's first foray into 


creation took flight. “I honestly thought [it] would ee eee : | 
fd Kinde" asyne” opcodes "@" mncmonic="Gps_Repa 


be too heavy to achieve lift, but what do ya know, 5 cemmar tea re cabanted (RCA em aint ERIE eed Tate 
it flew! It went up maybe 30 ft and we were able to sf command= 
check the sensors by moving it close and far from ht aee one 
the SparkFun HQ [where she works].” 

While the drone’s battery depleted in “a matter 
of minutes” due to its additional load, the Epigone 
worked well and could be deployed to map small 
areas of land such as elevation changes ina 
garden, Avra suggests. {/] 





03 Avra built a lidar component using NASA's GPS 

template to create the component through XML, 
then deployed the component on her native host and 
cross-compiled it for Raspberry Pi. 
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Temperature 
monitor 


A simple, cheap, and contactless solution for 


Na | Pasx=) alcxe) ¢ 


taking people's temperatures with Raspberry Pi. takes the user's 


temperature 


Rob Zwetsloot checks it out 
ver the past 18 months, a lot of workplaces 
0 have introduced temperature checks for 
employees and customers, and healthcare 
fields are no different. While some use expensive 
hand scanners, Philip Koreski figured out a 
different solution: “I recently designed a touch-free 
temperature reading station for determining whether 
the employees in our office are fit for work or not, 
based on their temperature.” 
At Philip’s workplace, a laser eye surgery, 





Philip Koreski 





A programmer 


in the healthcare employees would need to get their temperature taken 
informatics and then fill out a paper form to confirm that they 
department at Pacific could work. 

Cataract and Laser ee : : be eas , 

institute in Chehalis I was given the assignment to digitise this process 
Washington. He using a touchscreen device,” he tells us. “I thought 
primarily customizes that it would be nice to combine the process of taking 
electronic healthcare t t cll ee Theoth 
Aeaeeneiccnn our temperature with filling out the form. The other 
develop applications thing is that everyone who used it would have to 

to improve clinical touch the screen, so I figured if facial recognition was 


MCI OUECMICICNCY: incorporated, it would be more hygienic. So what was 


developed is a Raspberry Pi-based device with an IR 
temperature sensor that can recognise the employee 


14 | magpi.cc | Temperature monitor 











A Raspberry Pi Camera Module 
UIT rele c-Yorolelalisiolal= lalouve) aat= 
gestures to identify the employee 
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> 37°C/98.6'F Is 
only an average 
for adult body 
temperature... 


> It usually 
ranges between 
36.1°'C/97°F and 
37.2C/ 99 F 


>» The monitor uses 
a contactless 
MLxX90614 IR sensor 





> The case was 
Prompts and results are shown 3D-printed and 
on the screen, so users know designed in Blender 
| their temperature 








> A Haar cascade 
) is a type of object 
recognition used in 
face detectors 


Temperature monitor | magpicc | 15 


Ms Magi | PROJECT SHOWCASE 





A Designing in Blender 
allows for tweaking 
and rapid-prototyping 


o i oe | 







™ The facial recognition works well to identify 
the registered users and the temperature 
reader |s pretty accurate too @ 


7 _ infront of it, take their temperature, and log 
— ~ whether it is too high or acceptable for work.” 





Cool design 
_ The touchscreen integrated into the monitor also 
=== = = . — ~~ allows for manual entry if required. 
SS — =. — = = = “Raspberry Pi is an obvious choice for a project 
Se SS — ————_—Ssilike this,” Philip explains. “It is compatible with 
=== | = = Ss a wide range of sensors, has the processing power 
to be able to handle things like facial recognition, 
and it has the conveniences that come with a full- 
blown operating system. On top of that, it has great 
support for Python and most of the libraries needed 
straight out of the box. I do a lot of my software 
development in Python, so this is a major plus.” 

Development happened over the course of three- 
to-four weeks as a Side project, programming, part 
sourcing, and 3D design for the case. 

“The largest part of that was actually hand 
eesture recognition believe it or not,” Philip says. 
“T wanted a good way to signal to the device that 
it got the identity of the user wrong. It took a lot 
of trial and error, but eventually I found a Haar 
cascade for palm recognition and that seemed like 
a good way to tell it to ‘stop’. But the nice thing 
is that something relatively complex, like facial 


& The 3D-printed case 
is quite simple, and 
easy to mount on 
a wall 


> A Raspberry Pi, 
speaker, and display 
connector are 
squeezed into the case 





16 | magpicc | Temperature monitor 


MagPi 


Temperature check 


PHILIP KORESKI 4 





The monitor is mounted recognition and temperature reading and logging, 

to a wall So you have to : 

wellenaetit can be done by one developer in a reasonably short 
amount of time.” 








First, the device needs to recognise the user. 
Hot product This happens in under a second, however it 


With projects like this, there’s always a concern gives a five-second window which allows for manual 
that it won’t do its job. That was not the case for CNENIGIS 1V WUSTE! 2) CUSTe eu ialee mon. 
this monitor. 

“The facial recognition works well to identify 
the registered users and the temperature reader 
is pretty accurate too,” Philip reveals. “In testing, 
we’ve found that distance from the sensor plays 
a large roll in accuracy, so we will be working on 
ways for the users to have an easier time placing 
themselves in the correct range of distance from 
the sensor. Overall, the response has been pretty 
eood from the users.” 

Currently, the monitor is still being tested, 
but, if it passes, Philip hopes to get it rolled out 

Amanualmode canbeused —_ throughout other departments in the company, 


to override the automated 
system if required and hopefully further. 





The IR sensor requires the user to be a lot 

closer than the camera, so the user steps up 
to the machine and places their head a couple of 
inches away so an accurate temperature can be 
taken and recorded. 


45 


COVID-19 Staff Attestation of Symptom & Temperature Check 


All staff are required to self-screen at home each day prior to coming to work. 
symptoms include:Fever (defined as 100.4 or higher), Shortness of breath, Cough, Body aches/chills/imuscle pain, 
Fatigue, Sore throat, New los: ell, Congestion or runny nose, Nausea or vomiting, and Diarrhea 
“Also being exposed to anyone confirmed positive for Covid-19 


Location: 


Temperature: 98.5 


i] 
| 


Chehalis - HCI | 
| 


DATE: EMPLOYEE Jab Tithe: ANSWER 





OS 17 20F1 Philip Koreski Programmer ¥ ] 


The system analyses the data and gives the user 
a pass or fail. If the system isn't working properly, 
a manual mode can be enabled where a user selects 


themself and then confirms whether or not they're fit 
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Apple 1Pad 
Magic Mirror 


Salvaging a smashed first-gen iPad by combining it 
with Raspberry Pi Zero. David Crookes reflects on it 








Chris Greening 


Chris Greening 

is amaker based 
in Edinburgh. 

He really enjoys 
building projects 
with embedded 
electronics and 
sharing what he's 
learnt with 

the community. 


magpi.cc/ 
ipadmirror 


Chris says he's not proud 


of the wiring, but it works. 


A USB cable was hacked 
apart to supply 5V of 


power to Raspberry Pi Zero 





pple launched the iPad in 2010, but the 
first-generation tablet was discontinued 
the following year and there were no more 
iOS updates available for it after 2012. So, many of 
these debut devices were either binned, sold on, 
or consigned to drawers. Yet, as Chris Greening 
proves, Raspberry Pi can blow new life into them. 
“My iPad was so old that apps didn’t really 
work any more and the Safari browser wasn’t 
performing well with modern websites,” he says. 
“The glass was also cracked and the batteries 
didn’t charge, so it was heading to the bin.” Or at 
least it was until Chris decided to use it as the basis 
for a Magic mirror. 
Chris had explored such a project before, using 
a Fire tablet for the display. By swapping it for an 
iPad, however, he was able to liberate the Amazon- 
made Fire device for day-to-day use. What’s more, 
since he’d already written a magic mirror web page 
and server, the switch proved relatively easy. 


Peel it away 

The project entailed removing and using the iPad’s 
screen. “I knew, from watching a few videos on 
iPad repairs, that the LCD screen was completely 
separate from the glass, so it seemed a shame to 
throw the whole thing away without at least trying 
to salvage some components,” he says. 
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A The screen displays lots of information from a website set up 
by Chris, who is considering creating a smaller mirror 


Unfortunately, this was the most difficult part of 
the build. “It’s a lot easier if the glass is not already 
cracked,” he explains. “In theory, you should just 
be able to pop the glass out from the metal frame, 
and using a thin metal spudger seems to be the way 
to go. As my glass was already cracked, I went with 
a much more brute force approach.” 

Once he’d isolated the screen, it was then a case 
of hooking it up to a Raspberry Pi Zero W. This 
required a driver board. “The main thing to check 
is that it’s definitely compatible with the first 
iPad’s LCD screen which has the model number 
LPo97X02,” Chris says. “The driver boards to seem 
to be fairly standard now.” 


The core business 
Raspberry Pi Zero W — powered using a5 V buck 
converter and running Raspberry Pi OS — proved to 
be a perfect match. Being thin, it fits nicely behind 
the mirror. “It’s also so affordable but can still runa 
full operating system with a GUI and it has wireless 
LAN, too — those are probably the most important 
things for this project because | really needed to be 
able to run a web browser,” Chris says. 

After setting the Chromium browser to auto- 
Start in full-screen kiosk mode, it was pointed at 
Chris’s magic mirror URL. “But there is some really 
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Raspberry Pi Zero is set to output 
at a screen resolution of 1024x768 
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> The driver board 
cost Chris £28 


> The Chromium 
browser launches 
in kiosk mode 
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@ There is some really nice 
magic mirror software 
available for Raspberry Pi & 





nice magic mirror software available for Raspberry 
Pi, so I may look at switching over at some point,” 
he muses. From that point, it was a matter of 
fitting everything together. 

“The main challenge was ensuring the 
components wouldn’t stick out from behind the 
mirror too much,” he reveals. “The driver boards 
come with VGA and composite connectors which 
are quick thick compared to the actual PCBs.” 
There was also a problem with the screen’s 
brightness, solved using tinted acetate sheets, but 
otherwise everything went to plan. 

“You can pick up refurbished, second-hand ———— 
iPad LCDs on eBay for very good prices, especially A The LCD display has been 
if they have a couple of dead pixels,” Chris says. ope a oan FeoanG 


connected to Raspberry PI 
Zero W using a driver board 


| | 
u i 1 
| ie 


* of aL. « 
APTOS Tees 





TI 





“You can create a very affordable display.” Hl 
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Bluebot Shoal 


Fish Robot 


If you loved the film Finding Dory, you might just enjoy the 
Original story of these underwater robots, suggests Rosie Hattersley 





Florian 
Berlinger 





Florian is fascinated 
by displays of 
collective intelligence 
and co-operation such 
as schools of fish and 
teams of robots. 


florianberlinger.ch 





in this Raspberry Pi Zero W project look more 

than a little like Dory from Pixar’s movie. 
As with the film character, the Bluebot robot fish 
are based on the blue tang or surgeonfish. Unlike 
Dory, however, these robot fish are designed to 
be anything but loners. They behave collectively, 
which is the focus of the Blueswarm research 
project that began in 2016 at Harvard University. 

Florian Berlinger and his PhD research project 

colleagues Radhika Nagpal, Melvin Gauci, Jeff 
Dusek, and Paula Wulko set out to investigate 
the behaviour of a synchronised group of 
underwater robots and how groups of such robot 
fish are co-ordinated by observing each other’s 
movements. In the wild, birds, fish, and some 


t’s no coincidence that the shoal of robot fish 


A The Blueswarm team designed a PCB and wrote custom 
Python code for their subterranean Raspberry Pi experiments 


20 | magpi.cc | Bluebot Shoal Fish Robot 


animals co-ordinate in this way when migrating, 
looking for food and as a means of detecting and 
collectively avoiding predators. Simulations of 
such swarm behaviour exist, but Blueswarm has 
the additional challenge of operating underwater. 
Raspberry Pi Zero W works well here because 
multiple Bluebot robots can be accessed remotely 
over a Secure wireless connection, and Raspberry 
Pi Zero W is physically small and light enough to fit 
inside a palm-sized robot. 


Mimicking movements 

The team designed the fish-inspired, 3D-printed 
robot body as well as the fin-like actuators and the 
on-board printed circuit board which connects to all 
the electronics and communicates with Raspberry 
Pi Zero W. Designing the robot fish took the team 
four years, from working out how each robot fish 
would move and adding sensing capabilities, to 
refining the design and implementing collective 
behaviours, coded using Python 3. 

They used as many off-the-shelf electronics as 
possible to keep the robots simple, but adapted 
existing software algorithms for the purposes of 
their investigations, “with several clever twists 
on existing algorithms to make them run fast on 
Raspberry Pi,” adds Florian. 

On-board cameras that offer “an amazing 
360-degree field of view” are one of the project’s 
real triumphs. These cameras are connected to 
Raspberry Pi via a duplexer board (so two cameras 
can operate as one) the project team co-designed 
with Arducam (see arducam.com). Each Raspberry 
Pi Zero W inside follows the camera images and 
instructs the fins to move accordingly. The team 
developed custom algorithms for synchronisation, 
flocking, milling, and search behaviours to 
simulate how real fish move individually and as 
a group. As a result, says Florian, “Blueswarm 
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There's a video 
about the Bluebot 
shoal on YouTube 
(magpi.cc/ 
swarmoffish) 
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instructions 
issued wirelessly 
over a VPN 


Blueswarm are 
going to study 
open water marine 
behaviour next 


When tackling 
complex projects, 
break them into 
smaller tasks... 


Start simple, 
develop and 
test each stage 
individually, 
Florian advises 


On-board cameras offer an 
amazing 360-degree field 
of view 


can be used to study inter-robot co-ordination in 
the laboratory and to learn more about collective 
intelligence in nature.” He suggests other robot- 
based projects could make use of a similar setup. 


Imitation of life 
Each robot fish cost around $250 and took 
approximately six hours to make. To make your 


own, you’d need a3D printer, Raspberry Pi Zero W, J ’ 
a soldering station — and a Suitably large tank for . | . 
your robot shoal! Although the team hasn’t made f i= F ' 


the code available, the Blueswarm project paper 

has recently been published in Science Robotics 

and by the IEEE Robots and Automation Society 2:2. ye 
(ieee-ras.org). Several biology researchers have also = 

been using the Bluebot shoal as ‘fish surrogates’ in figeveclee wis, bar eluebet 
their studies of swimming and schooling. has a serious purpose 
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Controlling g commercial mini-split heat pump Using a Raspberry 
P|, Rob Zwetsloot cranks up the heat on this cheaper solution 


A It'sa fairly simple 
Raspberry Pi Zero 
setup inside the case 





Robert 
H'obbes’ Zakon 





An entrepreneur, 
technology 
consultant, and 

a former White 
House Presidential 
Innovation Fellow. 
He has a passion for 
using tech to make 
lives better. 


magpi.cc/ 
minisplitpi 
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fter installing a photovoltaic (solar) 
system with battery backup, managing 
home loads during grid outages became 
important,” Robert H’obbes’ Zakon says in his 
write-up for his MiniSplitPi. It’s a remote-control 
device powered by Raspberry Pi that controls a 
mini-split heat pump, which is a kind of heating 
and cooling unit used in some homes. 

“Mini-split heat pumps use a lot of energy when 
it is really cold out, and are the one home device 
we have that may continue to run unnoticed during 
an outage, such as when we are asleep or out of 
the house, causing the batteries to drain down 
rapidly,” he explains further. “So, finding a way 
to automatically shut them off at the start of an 
outage became the goal of this project, and in the 
process ended up with full web control of the mini- 
splits. Yes, they could have been put on a separate 
panel that is not powered during an outage. 
However, what’s the fun in that? We still wanted 
the ability to run them for A/C during the summer 
when they don’t use up much energy.” 


Cheaper alternative 

While there are commercial products that perform 
this function, they tend to cost around $200 
(£140), whereas Robert’s Raspberry Pi version 
costs only $20 (£14) for each device. They also 
wouldn’t perform the shut-off during the grid 
outage that he originally planned to control. 


The MiniSplitPi is connected via a CM105 port on 
the heat pumps, which are usually used with the 
official remote control products. 

“The CN105 connector pins provide 12V, 
eround, 5V, TX, and RX,” Robert explains. 
“Communications are through the serial UART 
(TX/RX). Although the 5 V could possibly be used 
to power Raspberry Pi, in an abundance of caution 
the 12 V was used instead, along with a buck 
converter to step down the voltage to the required 
5 V for Raspberry Pi. Similarly, the CN105 TX/RX 
are 5V, whereas Raspberry Pi requires 3V, soa 
bidirectional logic level converter was used.” 

Robert added other features, such as a shutdown 
button if wireless contact is lost, an LED for at-a- 
glance checks of the grid, and a motion-activated 
screen with more data and adjustable settings. 


Hot stuff 


“The MiniSplitPi has worked remarkably well,” 
Robert says. “Being able to control all of the 
mini-splits from a single web interface has made 
life easier. The one gotcha I have found, and am 
still chasing down, is trying to switch multiple 
heads from heating to cooling mode at the same 
time. This is usually only required twice a year, 
so turning them off then on again in the new 
mode, something that can be automated, is nota 
big issue. The primary reason for developing the 
MiniSplitPi has worked extremely well, though. As 
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™ Being able to control all 
of the mint-splits from a 
Single web interface has 
made life easier 


our home is now powered by photovoltaics with 
Tesla Powerwall batteries for backup, I wanted a 
way to have the mini-splits go off automatically 
after ten minutes if the grid goes down, so the 
batteries are not quickly drained. The MiniSplitPi 
worked as expected for the power outages we had 
over this past winter, and it has been useful to have 
the LED on it showing an active outage, as it is not 
always evident when the grid goes down.” 

Plans for a big touchscreen to work as a Despite how modular and 
thermostat are in the works as well, so that it’s acess cniedar ei he 


are, it's always best to test 
more accessible to family members. ! before installation 
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> Robert previously 
made the Al- 
powered Seeing 
Wand 


> Raspberry Pi Zero W 
is one of his favourite 
micro computers 


> The outputs were 
decoded to create a 
Python library... 


> .. which you can find 
here: magpi.cc/ 
mamitsi 


> The full build includes 
a custom API if you 
plan to replicate it 
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Pico Pong 


Recreating an arcade classic with gesture control on 
Raspberry Pi Pico. Nicola King connects bat with ball 








Nick Bild 


A software engineer 
by day, Nick is a 
hardware hacker 

by night. His formal 
education is in 
computer science 
and bioinformatics; 
he is self-taught in 
electronics. 


magpi.cc/ 
picopong 


Much of the project 
development involved 
debugging the VGA 
signal to get it just right 
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can use its Programmable Input/Output 

(PIO) capability to output a video signal, 
Nick Bild was inspired to recreate the arcade 
classic Pong. Not only that, but he’s made it 
eesture-controlled. 

“T love playing old games in RetroPie on my 
Raspberry Pi 4 with my son Luke,” he tells us, “so 
when I realised what a perfect fit Pico’s PIO would 
be for generating a VGA signal, my mind went 
to a reimagining of one of the greatest games of 
all time.” 

It took Nick about three weeks of nights and 
weekends to build Pico Pong: “TI have a day job, so I 
have to fit my projects in when I can.” 

The difficult part was getting the VGA signal 
timing just right. “Once I had that locked down, it 
only took me a couple of hours to code up the Pong 
algorithm and graphics,” he reveals. 

Since Pico’s PIO handles the cycle-intensive 
process of generating video, this leaves the CPU free 
to do other work, like play Pico Pong. “TI use the PIO 


A fter discovering that Raspberry Pi Pico 








to generate a 640x480@60Hz monochrome VGA 
signal,” says Nick. “Data for the display is stored 
in a buffer in SRAM, which the PIO program grabs 
at exactly the right nanosecond, as it paints the 
screen, via DMA [direct memory access].”’ 

As well as overclocking Pico to 258MHz, 
nearly double its standard speed, it took a lot 
of incremental tweaking to get the VGA signals 
exactly right. “I had to reorganise and rethink the 
PIO assembly code a number of times to get the 
data for each pixel on the GPIOs exactly within its 
40 nanosecond window.” 


Gesture control 

The player’s on-screen paddle is gesture- 
controlled using two infrared (IR) LED / IR 
phototransistor pairs. “The IR LED shines upward 
onto a mirror, which reflects the IR light back onto 
the receiver below,” explains Nick. “When that 
signal is interrupted (i.e. by a hand), it triggers Pico 
via GPIO to move the player paddle. One receiver 
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moves the paddle up on the screen, and the 
other moves the paddle down.” 

Why gesture control? “I wanted to do something 
different from the typical potentiometer 
controller, so 1 did some digging through my parts 
bins to get ideas,” Nick replies. “I first thought 
I might use a PIR sensor for a similar gesture 
interface, but even with hardware modifications it 
wasn’t responsive enough.” 

As an alternative, he tried the IR LED/ 
phototransistor pair and responses were smooth 
and instantaneous. “After playing around with 
this for a while, I feel like this is the way Pong 
was meant to be played. If my idea weren’t over 
40 years late, I think this could have been the 
Nintendo Wii of the 1970s.” 


Game, set, and match 

After showcasing the project on Hackster.io 
(magpi.cc/picopong), Nick has received plenty 
of positive feedback from the maker community. 





The side-to-side hand 
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Pico Pong took 
Nick around three 
weeks (in his spare 
time) to complete 


M |'ve found that many 
people are drawn to this 
new way of playing a 
classic game 


This is his first 
Pico project, but 
Nick has made 
many Raspberry 
Pi projects 


Vv 


“There’s a lot of love for Pong, so I’ve found 
that many people are drawn to this new way of 
playing a classic game,” he says. “People see 
this as something that they could realistically 
build for themselves, and I think that’s right. 
With the coding already done, there is only a 
simple circuit to build, and the Pico is a very 
inexpensive development board.” 

Nick advises us to keep our eyes open 
for updates to the projects in the future. 


Vv 


They include Deep 
Clean (magpi.cc/ 
deepclean).. 


which watches 

a room and flags 
up which surfaces 
need cleaning 


Vv 


> His Speaker Snitch 
Meanwhile, he’s currently experimenting imiagpiiec/snitch) 
with using his Pico to remotely control a toy Aschacwhanevera 


helicopter. “I’d like to teach it some new tricks, 
and control it by voice and/or gestures.” Wl 


smart speaker talks 
to the cloud 
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RUHAcam 


Ruha Cheng and Penk Chen have created a printable retro-style, 
high-quality digital camera. David Crookes sees no negatives 








he High Quality Camera for Raspberry Going down the retro route has had another 
T Pi has been catching the eyes of keen benefit. “The body size of an old camera is a 
photographers for more than a year now. perfect fit for DIY projects and there’s lots of 
Ruha Cheng It’s been placed at the centre of many wonderful room for electronic parts,” continues Penk, who is 
and Penk Chen projects, but seeing it form part of a camera that a software engineer by trade. 
wouldn’t have looked out of place many decades Those parts include a Raspberry Pi Zero W 
Ruha is a part-time ago has made us snap to attention. computer, a 2.2-inch TFT display that has 
illustrator/ graphic Designed by Ruha Cheng and constructed by been used as a viewfinder and a 2000 mAh 
seacieaale cae her husband Penk Chen, the retro-styling comes lithium polymer (LiPo) battery. “I’m more of a 
Penk is a software courtesy of a 3D-printed case brought to life with smartphone camera user, but this project has 
engineer and a toy the addition of faux leather patches wrapped been a lot of fun,” Penk says. 
dake bermeiue gia around the body. “The look was inspired by 
Tokyo with two cats, . 2 
Musachiand: ire: Tokyo’s old camera shops,” Penk reveals. “Ruha Developing the project 
magpi.ce/ is an illustrator and designer and has experience From the outset the pair, who live in Tokyo, hada 
ruhacam with film cameras. So, naturally she led the design, clear goal: to make a usable Raspberry Pi camera 
which shows in the project’s name.” with easily available parts that other Raspberry 


Pi users could replicate. “The milestone for the 
V This version of the camera includes | project was to take a picture of the Toyko Skytree 
epee An ne eR tower from our balcony,” Penk says. So the couple 
got down to work to make it all happen. 

Ruha says the easiest — and most fun — part of 
the build was decorating the camera. “You can 
choose colours and paint, and decorate it with 
faux leather or wood veneer,” Penk adds. “The 
most difficult part for me was figuring out the 


WV The couple are working with a team from 
Taiwan to create an open-source camera 
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attached to a Raspberry 
Pi High Quality Camera 
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™ The milestone for the project was to take a picture of the 
Toyko Skytree tower from our Balcony @ 


wiring of the LiPo battery, with a DC-DC step-up 
converter and USB charging module.” 

The decision to use Raspberry Pi Zero W was 
straightforward enough, though. “It has excellent 
balance and it’s powerful enough to handle the 
camera’s full resolution, yet small enough to fit 
into our 3D-printed case,” says Penk. “But we 
opted for a smaller 2.2-inch LCD to reduce cost 
and skipped a video recording function so we 
could meet the cherry blossom.” 


Staying focused 

Helping keep the quality high, the 12.3 megapixel 
High Quality Camera with its Sony IMX477 sensor 
Supports C-and CS- mount lenses. Ruha and Penk 
chose a16mm, 10 MP telephoto lens and have 
been more than happy with the output. 


“The image sensor size (7.9mm) of the camera 
is equivalent to the sensors in the iPhone 5 era 
and even though it’s not ona par with APS-C 
or M4/3 sensors commonly found in mirrorless 
interchangeable-lens cameras (MILC), it’s 
definitely a luxurious upgrade from the Camera 
Module V2.” 

They’ve found the viewfinder helps to compose 
the best possible image. “It’s also a lot of fun 
manually adjusting aperture and focal lengths, 
which sometimes causes ‘happy accidents’ that 
you don’t get with a smartphone.” 

They’re certainly pleased with the results. 
“Since the project went live, we have received a lot 
of interest and much feedback from enthusiastic 
developers,” says Penk. “It’s literally technology 
married with liberal arts.” Wl 





Nor 
Feel . 





> The 3D designs are 
available on GitHub 


> Software and 
design are free 
under MIT licence 


> It uses the 
Raspberry Pi High 
Quality Camera 


>» Add your own 
design flourishes to 


the build 


> It remains a work- 
in-progress 
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Plant Rotator 


Here's d clever way to ensure indoor plants get an evenly 
distributed amount of sunlight. Nicola King cons her horticultural hat 








A. The finished project, 


without the plant. The 
blue sunlight sensor 
can be seen at the top 





Yohei Oka 


Yohei is a first-year 
MBA student at 

MIT Sloan with 

a background 

in software 
engineering. He was 
enrolled in a super- 
fun class called 
Introduction to 
Making (magpi.cc/ 
introtomaking), 
where he worked on 
this project. 


magpi.cc/ 
plantrotator 
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ooking after indoor plants can be 
challenging at times, especially when it 
comes to making sure that all parts of your 
plants are getting adequate light. This was an 
issue that Yohei Oka’s wife was experiencing, so he 
decided to address the problem head-on. 

“My wife was getting tired of having to turn 
her plant and I needed a project to work on for my 
‘Introduction to Making’ class [at MIT],” he recalls. 
The bud of an idea formed and, after about a month 
of finessing his make, the Plant Rotator was the 
very practical and ingenious result. 





Innovate to rotate 

The concept is simple but clever and uses sensors 
to monitor how much sun the plant has been 
subject to before rotating the 3D-printed plate 
that it sits on at regular intervals. “The device 
uses a Sunlight sensor and records sunlight levels 
every minute,” says Yohei. “Once the accumulated 
sunlight counter reaches a certain threshold, the 
device rotates the plant 90 degrees and resets the 
counter and repeats the same steps. If there’s a 
lot of sunshine, it might take an hour for the plant 
to rotate; if there’s multiple rainy days in a row, it 
might take a couple of days.” 





A Arobot car chassis forms a stable base for the plant rotator 


Yohei’s six-step Instructable guide 
(magpi.cc/plantrotator) covers how he connected 
his Raspberry Pi 3 to a stepper motor to rotate 
the plant, and how he attached a Grove Sunlight 
Sensor. He also needed something to build the 
rotator onto and opted for a basic smart car chassis 
kit, which provides some stability. He designed the 
3D-printed plate on which the plant sits. “I hadn’t 
used CAD before taking this class, but the plate 
didn’t take too long to design.” 

Yohei also needed a means of collecting and 
analysing the sunlight data, so he set up InfluxDB 
(a time series database) and Grafana (an open- 
source analytical application) on his Raspberry Pi. 
While he initially considered using an Arduino for 
the project, “I needed something more powerful 
to run cron jobs, keep track of the data collected, 
and visualise the data through a dashboard. I hada 
Raspberry Pi lying around, so decided to use that.” 


A great a-chive-ment 

As with every project, there were obstacles to 
overcome. These included ensuring that the rotator 
was fully stable and able to rotate with the weight 
of the plant (around 1kg in Yohei’s case), figuring 
out how to attach the motor shaft to the plate, and 


Equipped with a Grove 
Base HAT for easy sensor 
connection, a Raspberry Pi 
emero)al ice) K-M-\V(-ravanaliale| 
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> Yohei estimates he 
Spent 15-20 hours 





establishing the threshold to determine how often 7] My wife was g atti ng tI re e of on the project 
the plant should be rotated. The good news is that 
his wife’s problem plant is now “growing faster havin g to turn her D lant @ >» He used this 


tutorial to get his 
stepper motor 
working: magpi.cc/ 
stepperguide 


and more evenly.” 

Yohei’s invention has already attracted lots of 
interest. “I’ve received a bunch of feedback from 
plant owners Saying it’s a great idea and want to 
see it productised. They’ve asked me if I can build 
one for them or create one that can support a much 
larger plant.” 

As for future iterations of his rotator, he has 
some plant plans. “A couple of people in my class 
built devices that work on auto-watering plants,” 
he reveals. “It would be neat to combine my project 
with theirs so we can build a completely automated 
‘plant babysitting device’. It seems like plant 
owners would like to have such devices for when 
they go on longer trips.” 

For those of us not gifted with Monty Don’s 
ereen fingers, that sounds like a blooming 
brilliant idea. Hl 


> This chassis kit 
was used as the 
base: magpi.cc/ 
smartchassis 


> Yohei says a big 
challenge was 
“figuring out how to 
be resourceful’ 


> He recommends 
testing the plant is 
stable on the plate 
before attaching 
everything! 





A Superglued to a wheel that connects to the stepper 
motor, the 3D-printed plate was designed by Yohei 
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Learn to master Raspberry Pi and fix the problems that 
x plague newbies. By Wesley Archer cand Lucy Hattersley x 


+ 





getting hold of your first Raspberry Pi, 
especially with the seemingly endless 
of. possibilities for projects and builds to explore. 
Getting to grips with it all can be a little daunting, x 
especially for those new to the world of Linux. 
SSH - why are you telling me to be quiet? Sudo 
- isn’t that a board game? Headless - I want one 
with a head, please! 
You’d be forgiven for wondering what all these 
(se new terms are, but read on and you’ll not only 
learn what they mean, you’ll become a Raspberry 
Pi genius in the process! 


\Zz T here’s nothing like the excitement of 
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Identify your + 
Raspberry + 
Pi hardware 


With a range of Raspberry Pi 
computers to choose from, the 
first step to becoming a Raspberry 
Pi genius is to understand the 
differences between each model, as 
each has its own strengths depending 
on your project. You should identify 
your model of Raspberry Pi before 
(od axel bok can coy am ad bomr-balemr-Lenvacece 
If you want to know the precise 
version and revision of your Raspberry 
Pi, check the printed text on the board. 
See the Raspberry Pi product page 
for more information on each version 
So) eM Gu nk-t4 0) rece ho) nexe LU Cel a> B 
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Fix Raspberry Pi boot problems 


This is one of the most frequently asked 
questions! If your Raspberry Pi refuses to 
boot, there are a couple of things to try. 

First the good news. Your new Raspberry 
Pi is almost certainly not broken. Every 
Raspberry Pi is tested before it leaves the 
factory, so you can be confident that your 
Raspberry Pi has booted successfully at 
least once. While it is technically possible 
that your Raspberry Pi has a hardware fault, 
the chances are extremely slim. It’s almost 
certainly a problem you can fix. Try these 
Wabuotcscmbame) e(-)m 


1. You might be booting but not getting 
video output. First, check that your 
cables are connected properly. Take 
them all out and reconnect them. Try a 
different HDMI cable if you have one. 


2. Try a different power supply. It’s 
best to use an official power supply if 
you are in doubt — see Power Supply 
& Cables on Raspberry Pi’s product 
page: magpi.cc/products. 


a 


a 


34. magpicc Becomea Raspberry Pi Genius 


3. Take out the microSD card and use 
Raspberry Pi Imager to flash a new 
installation of Raspberry Pi OS to 
it (see magpi.cc/imager). 


4. Try a different microSD card. Make sure 
your SD card is fit-for-purpose, and not 
a fake. Some SD cards are unsuitable; if 
your card fails, it may be a good idea to 
try a different type. Get your microSD 
cards from a trusted source like The Pi 
Hut (magpi.cc/sdcard). 


Raspberry Pi has full instructions 

for setting up your Raspberry Pi 
(magpi.cc/setup), but if it still will 
not boot, you will find a great post 
packed with advice on Raspberry Pi’s 
forum (magpi.cc/bootproblems). 
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Common video issues are down to incorrect display 
settings - Raspberry Pi may be outputting video at 
a resolution your display cannot understand. 

First, check all your cables are connected and 
the microSD card is inserted properly. Try to re- 
power everything. 

Next, check what resolution settings your 
monitor is capable of. Most modern displays work 
at 720p as a minimum. If you have SSH access from 
another computer, use: 


Replacing with your Raspberry Pi IP address. You 
can use the tvservice application on the command 
line to determine which modes are supported by 
your device, along with other useful data: 





When connected via SSH, you can make 
changes using: 





And select ‘2 Display Options > Default Monitor 
preferred resolution’. Or one of the supported 
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Raspberry Pi video problems 


resolutions returned by tvservice. Exit out of raspi- 


config and reboot Raspberry Pi. 


But what if you can’t access Raspberry Pi via 
SSH? In that case, remove the microSD card from 
Raspberry Pi and attach it to a working computer. 
You will be able to access a range of files in the 
boot folder, including config.txt. Open this ina 
text editor and uncomment this line (remove the 


octothorp ‘#’ at the front): 





You can also use this file to adjust resolution 
settings, display modes, and other configuration 
settings. Transfer the microSD card back to your 
Raspberry Pi and boot up. See HDMI config for 


more information: magpi.cc/hdmiconfig. 








*« 


D } 


fe 


x 


FEATURE | Vdg?i 


x y a 


x 


Fix Raspberry Pi audio output 


Raspberry Pi can output audio in a couple of 
ways - typically via HDMI or 3.5mm jack (where 
applicable). Check the audio output settings 
and try setting the option to the way you are 
connected - i.e. HDMI for audio output via HDMI, 
typically to your display, or 3.5mm for speakers. 
Right-clicking the volume icon on the desktop 
taskbar brings up the audio output selector; 
this allows you to select between the internal 
audio outputs. 
You can also adjust audio settings in raspi- 
config. Enter the following into the command line: 








Select System Options > Audio and choose the 
option you want. 

In some rare cases, you’ll need to edit 
config.txt to force HDMI mode (instead of 
DVI mode, which doesn’t send sound). You 
can do this by editing /boot/config.txt and 
setting hdmi_drive=2, then rebooting for the 
change to take effect. See Raspberry Pi's 
documentation on Audio Configuration for more 
heuKoymenk-NMKO)eM@nrt-t:40) Mecerr-LUCelloleoyebat a» 





Use Raspberry Pi Imager 


Raspberry Pi Imager (magpi.cc/imager) is used 
to flash a microSD card with Raspberry Pi OS 
(or another operating system). It is installed on 
a Windows or Mac computer, or another Linux 
machine (including a Raspberry Pi you might 
already have set up). 

Prior to Imager there were other options, 
ipaKedhbCebbatcm@N\ COLO) stow Dele mel)betcamre(eMmoysmmalcmeeyanbent-batel 
line. From now on, you should use Imager. 

Want to know a secret code? Press 
CTRL+SHIFT+X when Raspberry Pi Imager is open 
to unlock a secret advanced options menu. Here 
you can preconfigure a range of options, such 
as enabling SSH, setting your wireless network 
credentials, disabling overscan, and setting a 
host name for Raspberry Pi. 


* 
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Fix Raspberry P1 
network problems 


There’s nothing worse than spending time 
setting up your Raspberry Pi, only to find out 
that you have problems getting online. Network 
problems tend to plague all computer users, and 
Raspberry Pi is no exception. 

It is, however, typically easy to get Raspberry 
Pi online if everything is working properly. When 
using a wired Ethernet connection, Raspberry 
Pi should connect automatically with no 
further intervention. 

Connect to a wireless LAN network using the 
Raspberry Pi interface. Click on the Wireless & 
Wired Network icon in the upper right of the 
screen, and choose your wireless network from 
the list of SSIDs (Service Set IDentifiers). Enter the 
password in the Pre-shared key field and click OK. 

If you are using a headless Raspberry Pi, use 
raspi-config instead: 


Choose ‘1 System Options > S1 Wireless LAN’ 
and enter the name of the wireless network and 
the password. 

To scan for wireless networks, use the command: 


This will list all available wireless networks, along 
with other useful information. Look out for the 
‘ESSID’ and ‘IE: IEEE’ fields, which are for the 
name of the network and type of security used. Use 
grep to filter just the network names: 





You should be able to open up a web browser 
and connect to the internet, or use ping in the 
command line to test your connection. 


But what to do if your network connection is not 
working properly? Here are a few steps to follow: 


1. Reboot your router. This will restart everything 
and assign IP (internet protocol) numbers to all 
your devices, including Raspberry Pi. 


2. Are other devices connected and working? 
There is a chance your ISP is having connection 
troubles. If so, go make a cup of tea. 


3. Reboot your Raspberry Pi. 


4. Check all your cables (and both ends of the 
Ethernet cable). Make sure it is connected 
properly. Try a different Ethernet socket 
on your router. 


5. Check your wireless connection. If you are using 
a wireless LAN connection, disconnect from it 
and reconnect. Click on the Wired & Wireless 
Networks icon and look for a network (it should 
have a green tick). If there’s no green tick, click 
on the network and enter your password. 


6. Remove and reconnect. Right-click on your 
connected wireless network and click OK in the 
Disconnect Wireless LAN alert pop-up. Head 
back to the Wired & Wireless Networks menu 
and choose your wireless network again (and 
re-enter the password). 


7. Move your Raspberry Pi away from other 
devices and closer to the router. Try an Ethernet 
connection instead and make sure that it 
is working. 
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Configure 
Raspberry P1 


The best way to adjust your Raspberry Pi settings 
is with the Raspberry Pi Configuration tool (via 
the desktop). Or, in the Terminal, you can use: 





Here you can fix several issues, such as enabling « 
the Camera Module, I2C, SPI, SSH, and VNC, as well e 
as change system options, like the audio output ® 
and changing the password for the ‘pi’ user. e 

@ 





BS ® @ 
@ = = ® 
~ Check your local network activity 
4 © ® 
_ Dropouts and poor wireless connections can be F3 a scan window to locate information about other | 
- caused by other devices around Raspberry Pi. networks in your vicinity (run wavemon as root @ 
Use wavemon to take a look at the network activity: with sudo to access this). For moreinformationon 
i wavemon, use the man pages: a 
Sa ° 
(a 4 — man wavemon 
. Now enter: é 
. With wavemon, you can see other networks é 
- sudo wavemon = and what channel they are operating on. Lots 
P of networks in the same channel can cause % 
_,..to open a monitor for your connection. Here interference with each other. Most routers 9 
you can see the link quality (higher is better) and 10) Cel a= red nba baC=y ar hone) an k-ha ler Uhiaur-p aXe my(o)umer- bal “ 
signal level (a negative value, the closer to 0 the try setting a different channel in your router : 
better). Pressing F2 opens a level histogram, and settings interface. e 
© ® 
® 6 
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“’ You control your 


Raspberry Piremotely from | 
another computer instead " 
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(Cf=} mere) abal=yerx-el 
with SSH and VNC 





Bookmark these pages for 
troubleshooting help and advice. 
The Raspberry Pi forum is a 

oye] aa celUlf-lahvmecolere mo) f-ler-m Cok: aie) 
help and advice. 


Raspberry Pi forum: ‘Help, 
X-acYo] UL gex=aour-] ave im era al (ex-]| 
Documents (start here)’ 
magpi.cc/forumhelp 


Raspberry Pi forum: 
BCT-Vndlalemeye-laccye i 
magpi.cc/forumgetstarted 


Raspberry Pi forum: 
‘Boot Problems’ 
magpi.cc/forumbootproblems 


Raspberry Pi forum: ‘Common 
pitfalls for beginners’ 
magpi.cc/forumpitfalls 


Raspberry Pi Configuration 
documentation 
magpi.cc/configuration 


Raspberry Pi Documentation 
raspberrypi.org/documentation 
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Raspad 3.0 


An ideal programming tablet perfectly compatible 
with Raspberry Pi 4B. What’s more, Is that It’s 
Open-source and specially designed for physical 
computing projects. 

Compatible with Raspberry Pi OS, Ubuntu Desk- 
top, Chromium OS, Android and more 
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DietPi 


As a 3D Printer Monitor 


<2) dam aale) a= 
raspad.com/products/raspadv3 





Start to Play Games Creat IOT projects 
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K.G, 
Orphanides 





K.G. is a writer, maker 
of odd games, and 
software preservation 
enthusiast. Their 
household can 

now hold very retro 
Street Fighter II 
tournaments, and 
that's beautiful 


@KGOrphanides 





Build an arcade machine: 
Decorate your cabinet 


You've Built gn arcade cabinet, but viny! 


decals and edge moulding will bring It to life 


ost arcade cabinet kit suppliers print 
pre-designed or custom vinyl decals 
to decorate your cabinet. Third- 
party printers can produce vinyls to your 
specification, but make sure that you provide 
accurate measurements. 

Our vinyl decals, bought from Omniretro 
(magpi.cc/omniretro), arrived on a roll and 
had to be cut out, but some firms will die-cut 
vinyls for you. We’ll use a wet application 
process, which makes it easier to remove and 
reposition decals for a short while after initial 


M 





placement, to help you get a perfect alignment. 


A Mark up in chalk pen and 
use a metal ruler to help cut 
your screen decal to size 
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Flatten your vinyl decals 

If your vinyls all came on a single roll, the first 
step is to cut each of them out. First separate them, if 
they’re on a single roll, but leave generous margins. 
Spread them out on a table or on the floor and weigh 
them down - coffee table books and textbooks are 
good for this. Leave them for at least an hour or two: 
24 hours is better. 


Cutting out 

Now they’re flat, it’s time to cut out your 
vinyls. Try to get rid of all white matter on straight 
edges. The easiest way is to line up a long metal 
ruler so that it just covers the edge of the printing, 
and run a scalpel down the outside of it. Curved 
sections for the cabinet side panels are trickier, 
but you don’t need to worry about these as they’re 
easy to trim down once fitted. For now, trim them 
freehand and leave as much white overmatter as 
you feel comfortable with. 





Partial disassembly 

Depending on the design of your cabinet, 

you may need to remove a side panel to take out the 
acrylic marquee and screen panels. Before doing this, 
use a liquid chalk pen and ruler to mark the edges of 
your LCD display on the acrylic, so we can accurately 
hide the bezel. 

If you’ve previously fitted joysticks and buttons to 
your control panel, this is the time to remove them 
too. Apply steady pressure to the rear of snap-in 
style buttons to pop them out of the cabinet. People 
with large fingers may find a ButterCade Snap Out 
Tool useful for this. 





Applying vinyl to 

your marquee acrylic 
Two acrylic parts require individual application of 
vinyls: the marquee and the screen that goes in 
front of your monitor. The former is easy: remove 
the backing from the vinyl marquee decal and any 
protective film from the acrylic. Spray both the 
acrylic and the adhesive back of the vinyl with 
two or three squirts of application fluid. You want 
them to be damp all over but not awash. 


Pick up the vinyl decal in both hands and, starting wt Ct } The glowing logo is created 
at one end of the acrylic, line it up with the edges | | ayaa using light-permeable vinyl 
and paste it down. If you’re not happy with the 1 PaO on acrylic, with an LED strip 


positioning, firmly hold the vinyl and snap it back : | ry == mounted just behind it 

up — the application fluid will help it release easily. 5 , 
Once it’s positioned, use your applicator and 

a cloth to smooth it down, drive out any excess 

water, and remove any trapped air bubbles under 

the vinyl. Trim any excess vinyl spilling off the 

edge of the acrylic with a knife. 


Measuring your screen acrylic 
Cutting your screen decal to size is 
awkward. Before removing the screen acrylic 
from the cab, we marked the inner position of our 
monitor’s bezel on the acrylic using a chalk pen. If 
your cabinet has a detachable VESA mount, bring 
the monitor with you to help line everything up. 


Grab your screen vinyl rea 


|o=| ake) oMer-le)/at=1m-lare! 
and mark up the area to BA 


CUt Out = ya 


Measure the distance between the edge of the 
acrylic and the chalk line you drew on it. Measure 
in multiple places to be sure of distances. Our 
24-inch monitor’s positioning and bezel size 
means that we cut 35mm in at the top and sides, 
and 65mm from the bottom — yours will differ. 


Ghouls 'N Ghosts is available 
Kom oO \Vmlamtal-mOr-| olere]aaWa\ger-(o(=) 


Cutting your screen decal | \ A 7 VA S) Yel [U la amex) iK-re1t(o)aMelame)i=t-la8) 
= ' rate] eee Ae lalolel esate] ales-1 a9) 
Once you’ve taken the measurements, : ‘| | 
grab your screen vinyl and mark up the area to cut ‘ . TT. --" a Saal 
out. Mark on the side showing the picture, paying | <I> o~ pe : rn 
particular care to the corner positions. Double- nt at 9 ¢ — = 
check these by placing the acrylic on top to make in, ™ we 7s. — 





sure both sets of marks line up. | — Kn — 
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A Use a vinyl applicator 


and a cloth to stick 
down, remove 


excess moisture, and 
eliminate air bubbles 


from your decals 


You'll Need 


>» Vinyl decals 


>» U-moulding/ 
T-moulding 


> Scalpels/craft 
knives 


>» Strong scissors 


>» Liquid chalk 
marker pen 


» Metal rulers, tape 
measures 


> Vinyl application 
fluid 


> Vinyl applicator 


>» Neoprene glue 


Grab your metal ruler, place it along your 
marked line, and cut a rectangle out of the middle 
of the vinyl decal with a blade. If in doubt, err 
towards leaving too much vinyl rather than too 
little. To check positioning, put the acrylic over 
your monitor, and your vinyl over the acrylic: they 
should all line up. 





07 Screen decal application 

call Now, turn the vinyl upside down, remove its 
backing, spray it and the acrylic with the application 
solution, and stick it down using an applicator and 
cloth. Residual chalk marks can be wiped off using a 
bit more of the application solution. 

Allow both the marquee and screen decals to 
dry for a day, trim them if needed, slide them 
back into your cabinet, and reattach anything 
you removed. This will probably be the last time 





you do this, so make sure the side panels are on 
securely and are correctly lined up and bolted to 
your stand, if you have one. 

If you plan on back-lighting your marquee, 
this is a good time to put in your light. We used 
adhesive tape and supplied clips to mount a50cm 
USB-powered LED light on the underside of the 
marquee, just in front of the speakers. 


© Applying flat vinyls 

ws If you havea full-height cabinet or a bartop 
and stand, you’ll probably have a number of flat, 
front-facing areas to decorate — in our case, the 
front cupboard door of our stand, its base, and the 
front of its foot. Do these next to get your hand in. 

The drill is the same for all of them: place the 
vinyl decal face-down on the floor, remove its 
backing, spray both it and the surface you’re 





> We marked the inner 
position of our monitor's 
bezel on the acrylic 
using a chalk pen 
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applying it to, position your decal, and smooth it 
out with your applicator. Use a scalpel to trim off 
any overmatter. For the door, we applied the decal 
with the door in place — knob removed, starting 
at the top. We had to open the door to flatten and 
trim the vinyl in places. 


Control panel decals 

Most control panel decals wrap around the 
top and front of your panel. Buttons and joysticks 
should not be present during application. This is 
a relatively easy section to apply, but watch your 
position if there are decorative patterns designed 
to surround specific buttons or joysticks. 

You may need to trim overmatter from the sides 
with a scalpel to get the decal to fold over the front 
face properly. Be careful when smoothing the vinyl 
on this fold, as it can be prone to both trapped air 
bubbles and damage from the join beneath. 


Cabinet positioning 

Side panels are the largest pieces of vinyl 
you’ ll be applying, but they’re less intimidating 
than they seem. For a standalone bartop, one 
person can mount them in a vertical position 
with little fuss, as shown in Omniretro’s video at 
mMagpi.cc/omniretrovinyl. 

Full-height cabinets present more of a challenge 
due to their height and the size of the vinyl - a 
second person is useful here. You can apply long 
vinyls in an upright position, but we’d already 
attached rubber feet to our cabinet, so we used 
these to help pivot the cab down to lie on a sheet of 
cardboard on the floor. 











You can leave some white-space ae . va - 
overmatter on side panel decals = — 
before application, as they're easy Aes) ge 
Apply side panel vinyls to trim with a knife afterwards — ie 
Lying flat and sprayed down as before, it’s 
easy to line up the side-panel decal. Make sure Side panels gre the largest : 
everything’s covered — with two people, it’s easy . Top TI p 
to snap the decal back up if you make a mistake, DIECeS of VI ny! you'll 
then use a cloth and applicator to drive out excess Screen materials 
moisture. Use a Stanley knife to trim the vinyl to be ODp ly NQ 
size — its solid metal body makes it easy to follow Acrylic scratches 
the line of the cabinet’s curves. If your cabinet has separate stand and bartop really easily, so 
Go around again to remove any air bubbles and parts, but uses a Single sticker, there will bea aes Seetee 
; ; ba glass is an excellent 
ideally leave the vinyl to dry for at least a couple Slight ridge where these join. However, careful aligmnative tor your 
of hours before pivoting the cabinet back up and application (and a sympathetic vinyl design) cabinet screen. 
lowering it to expose the opposite side. Repeat makes this effectively invisible. Just be careful 
the process. smoothing around it. 
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Warning! 
Solvents 


Always use solvents in 
a well-ventilated area 
and keep away from 
open flames. 





magpi.cc/solvents 


46 magpi.cc 


Moulding 
We used U-moulding on our cabinet, with 
neoprene glue to hold it in place securely. First, 
measure and use scissors to cut two strips to go 
above and below the marquee — it’s better to cut 
these a few millimetres too long and then trim than 
it is to have a gap. 
Use a spatula to help apply neoprene glue 
along the edge you’re working on, then use the 
tube’s nozzle to apply glue to the inside of the 
U-moulding. 
To lock U-moulding into place, bend it backwards 
to spread the U-shaped section, push that onto 
the edge you’re applying it to, and then roll the 
moulding down along the edge, using a finger to 
push it into place. 


Build an arcade machine: Decorate your cabinet 


Highly flexible, U- and 
T-moulding are used 

to give a clean finish 
to the cabinet edges 





Demonstrated here without glue, 
flex U-moulding backwards and 
use a finger or thumb to press it 
P| into place on a cabinet edge 





When applying it to a long section, such as each 
side of your cabinet, start at the front underside 
— rubber feet help access here — apply glue to the 
cabinet edge and the first 50cm of your roll of 
moulding, and have someone else feed it to you as 
you work up and around the cabinet. When you get 
to the bottom at the back, cut off your moulding 
with scissors. 

T-moulding locks into a pre-cut groove along the 
edges of your cabinet, making it more secure, but 
it’s still a good idea to apply glue to the flat surfaces 
for security. Either way, use a rubber mallet to 
gently tap down your moulding at the end. 

You can use acetone to clean the glue off your 
hands and the moulding, but keep it away from 
the vinyl. 


Magi 
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After spraying the vinyl decal, and the acrylic, with our homemade inichi 
fluid, we applied it and smoothed down with an applicator and cloth Finishing moves 


Use a scalpel to cut out the vinyl above the 
button holes: locate a hole, pierce it with the blade, 
: : = : Slice until you find the edge of the hole, and then 
Vinyl application fluid follow the hole round to remove all the vinyl. Do 
this for all your joystick and button holes. 
You can buy commercial vinyl application As described in The MagPi #105 (magpi.cc/105), 
Auid (magpi.cc/vinylfluid), widely used by screw your joysticks back into place from the inside. 


Sone ue oMsduon relate been oda If you’re going to put protective acrylic panels over 
but we filled a spray bottle with the following 


Warning! 
Sharp objects 


Take care when using 


ROMCniacecornailia: your control panel, this is the time to do it — they’re knives and scalpels. 
held on solely by the buttons. 
j ; magpi.cc/handknives 
66 ml surgical spirit However, because our cabinet is for home use, 
132ml water we’ve left the vinyl bare for a more comfortable and 


2 drops washing up liquid attractive finish. If your cabinet will see lots of play, 


acrylic will protect it and cut down on wear and tear. 
You can use warm water with a drop of washing up é 
a i Whichever you choose, connect a DuPont cable to 
liquid alone, but the surgical spirit reduces drying 


times, which means less waiting between different each button and pop them into place. 
stages of application and decorating. Follow the instructions from issue 106 to connect 


your buttons and peripherals to Raspberry Pi. 
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If you don't have 

the room or budget 
for a 4-inch display 
like the one we're 
using here, the code 
could be adapted for 
smaller panels 
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Build a Weather 


Watcher station 
with public data 


Don't rely on last night's forecast, With Raspberry Pi Zero 
gnd an e-ink display, you can track weather changes In real-time 


ou’re heading out: what do you take? 
Y Hat, gloves, and scarf, or shorts, shades, 

and sun cream? The only way to be sure 
is to check the weather before you leave. With 
this project, which uses a 4-inch e-ink panel and 
Raspberry Pi, you can set up a weather display by 
your front door. Weather Watcher draws down live 
data from the web and updates every quarter of 
an hour - or more often if you choose. You get all 
the benefits of your own weather station without 
the additional expense or effort involved in taking 
readings from your own garden. 





Attach your screen 

We’re going to display our data on a 4-inch 
Inky WHAT screen. It uses e-ink, which we’ve 
chosen because it’s easy to read in bright sunlight, 
has wide viewing angles, and holds the image 





without drawing power between each refresh. 
We’ve chosen the black and red version, which is 
slightly more expensive than the mono edition, 
but as this project works just as well in all-black, 
you can opt for the mono version instead if you’re 
working on a budget. With your Raspberry Pi 
switched off, attach the panel to the GPIO header 
and secure it using the included standoff screws. 


Install the display 

Boot your Raspberry Pi. We’re using 
Raspberry Pi Zero W with a pre-soldered header 
for this project as we’ll only be performing one 
action every 15 minutes and speed isn’t important. 
When it’s finished booting, either open a Terminal 
window if you’re using the graphical interface, or 
connect remotely using SSH. At the prompt, type: 


curl https://get.pimoroni.com/inky | bash 


Press ENTER and wait for the display’s drivers, 
fonts, and example code to install. This can take 
several minutes on Raspberry Pi Zero. When it’s 
finished, reboot your Raspberry Pi to make sure 
everything’s been recognised. 


Grab an API key 

We’re going to draw down live weather 
conditions from OpenWeatherMap, which very 
generously makes a lot of its data available 

for free. To make sure it can tie each query to 








Currently 


We're downloading live weather data R: 


1.2° 
breken clouds 


sunset: 19:04 
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the screen every 15 minutes 


a specific user (so it can check it’s not being 
abused), you need to sign up for a free API key, 
which must be passed to the server every time 
you refresh the feed. Point your web browser at 
home.openweathermap.org/users/sign_up and 
provide the required details (make sure you’re 
happy with the terms, conditions, and policies 
before completing the sign-up). Verify your email 
address by clicking the link it sends to your inbox. 


Copy your API key 

Return to home.openweathermap.org, log 
in, and click ‘API keys’. You can generate several 
keys for different applications if you choose, and 
OpenWeatherMap will combine their cumulative 
usage to make sure you don’t exceed your free 
account limits (which are 1000 calls a day or 30,000 
calls amonth). You’1] be making fewer than 150 
calls a day for this project and, for the moment, 
can manage with a single API key, so copy the long 
string of digits and letters in the default Key box 
and save it ina text document. You’! need it later. 


Tonight 


1 


feel 
| 2.2 





aS 


10.3° 
feels like 
8.7° 





Set up PyYOWM 

The OpenWeatherMap data you’ || be using 
is delivered in indexed arrays, from which you 
can extract individual variables using Python. 
However, someone has already done the hard 
work for us by developing the PyOWM library, 
which bundles together your API key and weather 
query and submits them to the OpenWeatherMap 
servers. To install the library, type the following at 
the Terminal prompt: 


pip3 install pyowm 


Download and edit our code 

Everything is in place. You now just need to 
customise our code for your geographical location. 
Download the weather-panel.py script from 
magpi.cc/weathergit and save it at the location 
on your Raspberry Pi from which you’l] run it. For 
simplicity, we’ve saved it in the root of our user 
folder, at /home/pi. If you’re using the graphical 
interface and you’ve never worked with Python 
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You'll Need 


> Inky WHAT 
e-ink display 
magpi.cc/inkywhat 


>» OpenWeatherMap 
API key 
magpi.cc/ 
weatherapi 


>» PyOWM library 
magpi.cc/pyowm 
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TopTip @& 


Faster 
refreshing 


Even if you have 

a colour display, 
switching "red" on 
line 42 for "black" 
will soeed up the 
refresh rate, so long 
as you're happy 
with mono output. 


Gooseneck mini USB 
cables are ideal 

for mounting your 
Raspberry Pi and 
screen close to your 
front door. Just make 
sure the plug remains 
firmly in place 
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code before, open it in Thonny Python IDE, which 
you’ ll find in the Programming submenu. If you 
prefer to stick with the terminal prompt, try Nano, 
by navigating to the folder containing the script 
and typing: 


nano weather-panel.py 


07 Define your forecast location 
Move your cursor down to lines 10 and 11 
and replace [lat] and [long] with the co-ordinates 
for the location for which you want to show the 
weather. If you don’t know what these are, switch 
to your browser and visit latlong.net. Type in 
a location, being as specific as you can to avoid 
picking somewhere with the same name elsewhere 
in the world. When the site centres its maps on your 
chosen location, click within the satellite view on 
the exact spot you want if the indicator isn’t quite 
on target. Copy and paste the co-ordinates below 
the map and satellite windows into your code. 
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Provide your API key 

Paste your API on line 13, using it to replace 
[your API key] (keep the quotes in your code 

but get rid of the square brackets). Assigning the 
key to a variable lets the PVOWM library roll it 
into each request it makes, effectively unlocking 
your account in the process. The remainder of the 
block immediately below the API line pulls down 
temperatures for today, tonight, and tomorrow, 
and tonight’s sunset time, all of which can be 
useful if you’re deciding how long you can put off 
mowing the lawn. 





Get your colours right 

Lines 55 to 69 handle positioning the data 
on the screen, using black text for the largest part 
of the display, which shows the current conditions, 
and white text on a solid background for the 
smaller text showing what it will be like tonight and 
tomorrow. Drawing the solid background is handled 
by line 52, which defines a single large rectangle 


MagPi 


For example, you can run a backup of all your user accounts 
at 5 a.m every week with: 
05 * * 1 tar -zcf /var/backups/home.tgz /home/ 
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@reboot python3 /home/pi/weather-panel.py & 
*/15 0,6-23 * * * sudo python3 /home/pi/weather-panel.py & 


Starting on the top row, 280 pixels across the 
screen, and extending to the bottom-right corner. 
Specifying fill = 2 blocks it in with red pixels. If 
we had a mono panel, we’d use fill = 1 for black. 
Line 53 then draws a four-pixel-deep white line 
across the middle of the rectangle to divide it into 
two boxes. 


Test your weather panel 

Save your tweaked code (if you’re using 
Nano, do this by pressing CTRL+X to quit, and press 
Y when Nano asks if you want to save). Now, at the 
Terminal prompt, populate your e-ink panel for 
the first time by running the code. From the same 
folder in which your code is saved, type: 


python3 ./weather-panel.py 


The process will take a few seconds to initiate 

as it first needs to request the data from 
OpenWeatherMap, then extract the variables 

you require, and arrange the screen contents 
before physically refreshing the panel. Don’t 
assume something’s wrong if nothing seems to be 
happening at first. 


Set your panel to quto-refresh 

Did it work? Good. Now you need to set it 
to refresh every 15 minutes (or more often if you 
prefer). Type: 


Cut Text My Justify 





Crontab can be used to invoke jobs at set intervals. Here, we're 
using it to run the weather-panel.py code every 15 minutes 


sudo crontab -e 


If you’ve never edited crontab before, you’|l be 
asked which editor you want to use. Pick Nano 
(option 1). Key down to the bottom of the file and 
add the following two lines: 


@reboot python3 /home/pi/weather-panel.py & 
*/15 0,6-23 * * * python3 /home/pi/weather- 
panel.py 


Press CTRL+X to quit Nano, and press Y when 
asked if you want to save. 


Understanding that schedule 

The first of those two lines tells your 
Raspberry Pi to run the script as soon as it has 
rebooted. The second line also tells it to run that 
script, but every 15 minutes between 6am and 
midnight (there’s no point stressing the screen 
when we’re in bed). The first */15 effectively 
translates to ‘every 15th minute’ — i.e. every 
quarter. The @,6-23 signifies ‘at zero hour 
(midnight), then every hour between 06:00 and 
23:00’. The three asterisks that follow apply those 
timings every day, month, and day of the week, 
while the & on the @reboot line makes the script 
run in the background so it doesn’t hold up the rest 
of the boot process. 
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Pico-Vol 
Use Raspberry Pi Pico to make your own 
voice processing and sound effects system 





» Microphone 


» Pico Voice hardware 


ast month we saw how to make the 
hardware for the Pico-Voice changer. This 
month we breathe life into it by showing how 
to make ten funky effects using software. 





Infrastructure code 

As Pico is relatively new, there aren’t always 
the support libraries you need. The first problem we 
faced was the lack of support for the OLED display. 
There was a C++ library at magpi.cc/picossoled, but 
we couldn’t get it to work using just plain C. So we 
asked on the Raspberry Pi forum, and the owner of 
this GitHub site, Martin Kooij, stepped forward and 
reworked his solution to make it compatible with C. 
Many thanks to him for that. We also had to handle 
the rotary encoders in C, as the previous solution we 
used had been in Python. 





Mike Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 


magpi.cc/mikecook 


[ You'll Need 


Rotary encoders 

To use the signals produced by a rotary 
encoder, you need to implement a state machine, 
shown in Figure 1. This takes the two signals, CK 
(Clock) and DT (data), from the encoder and uses 
them to form a state variable number 0 to 3. Each 
state is Shown in the squares, and the transition 
required to move state machine to the next state 
is shown in circles. Only when the encoder has 
produced the correct sequence of states can we 
increment or decrement the counter. Any deviation 
from this — caused by, say, contact bounce — will be 
automatically corrected. 


headset magpi.cc/ 
headsetpb 


magpi.cc/106 


WV Figure 1 The state machine for reading a rotary encoder 
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FIFO buffer 

A FIFO is a First In, First Out buffer or 
queue, and is the basis of all but one of the effects. 
Figure 2 shows how they work: just like a post 
office queue, the first to arrive is the first who is 
dealt with. However, rather than have the data 
shuffled along in memory, it is far quicker if you 
use the concept of pointers to say which place in 
memory you add new arrivals and which place you 
read the data to process. By keeping the input and 
output pointer moving at the same rate, you can 
implement a delay. 





Effect 0 - Delay 

A diagram describing a delay is shown 
in Figure 3. Samples are taken from the voice 
signal at a regular interval — in the case of most 
effects here, this is at arate of 20,000 samples per 
second — and placed in the buffer. Then a sample 
is removed from the buffer and sent to the DAC 
(digital-to-analogue converter), and both pointers 
incremented. They are then checked to see if they 
have exceeded the buffer length and set back to 
zero if they have. Most people have considerable 
difficulty in talking when they hear their own voice 
coming back half a second later. 


WV Figure 2 How a FIFO buffer works 
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Updating buffer 
Remove first sample All other samples move one place to the left 
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Less work for the computer 
if the samples stay Still and the input and output points move 
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Effects 1 and 2 - 

Reverberation and Echo 
These might be thought of as different effects, 
but are implemented with the same code, only 
the setup parameters are different. These two 
effects are shown in Figure 4, overleaf. Unlike the 
delay, there are two or more output pointers — in 
our case, five. These are distributed throughout 
the buffer to give five increasing delays. Each one 
has a fixed attenuation before being passed on to 
an attenuation controlled by one rotary encoder. 
These delayed signals, together with the current 
input sample, are added together to give the 


output. The placing of the buffer taps and the fixed 


attenuation differ in the two effects. 


Effects 3 and 4 - 

Pitch Shift and Two Voices 
Shifting the pitch up or down is not as difficult as 
it might sound — the basic arrangement is shown 
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The trick is to have a very 
Short buffer of a 
few milliseconds 


in Figure 5. The trick is to have a very short buffer 
of a few milliseconds, and step the output buffer 
at a fractional rate. Of course, the buffer only has 
integer memory locations, so when accessing the 
memory you take the integer part of the output 
pointer, but the pointer itself and the increment 
value are floating-point variables. We thought 

it would be fun to have two pointers picking up 
different parts of the waveform and applying a 
variable shift to each. 


Effects 5 and 6 - Backwards 
If you take a simple delay but drive the 
output pointer backwards — that is, decrement 
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Top Tip 
Head set 


You will need 

a headset with 
separate jack plugs 
for microphone and 
headphones, not a 
USB connection. 


Figure 3 
Implementing a 
simple delay 
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Output 


A Figure 4 Creating 
reverberation 
and echoes 


Short buffer about 


as long as the lowest pitch period 


>» Figure 5 Real-time 
pitch shifting 


Input Output 
—_> —_ 
Advance 1 per sample Advance x.y per sample 
Output at fractional rate 
> 1.0 = pitch up 
< 1.0 = pitch down 


WV Figure 6 Recording and then playing it backwards 
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it — the result is that it is played backwards, and 
sounds like you are talking in Russian. You actually 
get a variable delay, but you need that to generate 
the real-time backwards effect. It is great fun to 

try to say things backwards and hear them come 

out recognisably forwards, although sometimes it 
sounds a bit slurred. Figure 6 shows a record/replay 
version of the backwards effect, which is great for 
learning individual words. You can set a trigger level 
so you don’t start recording until a sound is made. 


Effect 7 - A Dalek 

When the BBC created the Daleks for Doctor 
Who, they asked their Radiophonic Workshop to 
create a voice for them. This was done by using a 
ring modulator to treat a voice, so its amplitude 
was modulated by a sine wave. In other words, 
the volume of the sound was turned up and down 
rapidly, about 30 times a second; this is known as 
amplitude modulation, or tremolo. This creates 
both the sum and difference of the two signals being 
multiplied together. Figure 7 shows how we created 
it. The square and saw-tooth waves sound gritty due 
to the sudden jump in the waveform. 


Effect 8 - Vibrato or ag Wobbulator 


While modulating the amplitude of a signal 
is called tremolo, modulating the frequency of a 
signal is known as vibrato. This is our favourite 
effect and is great fun. It makes the voice wobble, 
and controlling the rate of the wobble can make 
some very silly sounds. We use the same basic 
technique as the pitch shift effects, but with the 
increment rate of the output pointer varying by the 
output of a sine wave generator. This is shown in 
Figure 8, and the depth of the effect and the speed 
of the wobble are controlled by the rotary encoders. 


Effect 9 - Musique concrete 

Musique concrete is a French phrase 
describing a technique of recording sounds on tape, 
chopping it up, and joining the bits together ina 
random sequence. The theoretical concepts were 
first outlined the 1940s, but it became popular in 
the 1950s with the advent of tape recorders. For 
our effect, we record a buffer of sound samples 
and then continuously play back sections of sound 
in arandom order. Pushing the right-hand rotary 
encoder stops the playback and puts the system 
into record mode again. Figure 9 shows how we 
do this with the buffer split into four sections. 


WV Figure 7 Producing a Dalek effect 
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™ Modulating the frequency 
of gd signal is known 
gs vibrato 


The software 

The code can be obtained from GitHub 
(magpi.cc/pibakery) and we supply both the source 
code and the pico-voice.ufz2 file to drag and drop 
onto Pico. The overall program flow is shown in 
Figure 10; it shows the program is in two parts. First 
off, we have a check to see if the effects number has 
changed — if not, which is most of the time, we call 
the function that creates the sample. This is done 
by a vector jump table for speed. Any control signal 
generates interrupts that either change the effects 
number or the parameters of the effect. 


Finally 

This set of effects are not exactly studio 
quality, but they show what can be done with the 
minimum of extra hardware. They are definitely 
ereat fun and you can spend hours exploring 
what sounds they can generate using different 
control settings. Speaking with a short delay, 
and learning to ignore it, has even been used as 
therapy for people with a stutter. Perhaps the 
biggest limitation on quality is with the internal 
ADC, which has to be said is a bit noisy. Using an 
external one will improve matters, as will usinga 
DAC with more bits. WI 


TUTORIAL | MagPi 


Short buffer about 
as long as the lowest pitch period 











Audio 


Input 





Input Pointer 


—> Output pointer 
Advance 1 per sample > 


Output Controls Pointer Advance 








A Figure 8 The vibrato effect 


0.5 second Stage 1 Record 





——— > 
uw ~~, Skip back if not triggered 


Input 
—_ 


Advance 1 per sample 


Input 
When pointer reaches here 
Trigger replay 


Stage 2 Replay 


| 
| 


Play 3 Play 4 
——_—_—_—> 


Continue to play random parts until right rotary encoder is pressed 


Play 1 Play 2 
re 


A Figure 9 Musique concréte 


WV Figure 10 Software program flow 
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» Figure 1 Flood the 
squares with one colour 
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Create GUIs with Python: 


Flood It 


Learn how to use a Waffle to create a tasty game 


the board with all squares the same colour. 

Beginning with the top-left square, players 
choose a colour to flood into. It offers a slightly 
more complex Waffle-based game. 


C lood It is a game where the aim is to flood 


Aim of the game 

In this example (Figure 1), the top-left square is 
blue. The player could either choose to flood into 
the single purple square below, or to flood into the 
yellow square to the right. 

Flooding the yellow square would be a better 
move because all adjoining yellow squares would 
also be flooded, and the player is only allowed a 
limited amount of moves before the game ends. 


Set up the game 
Download (from magpi.cc/floodit) and open 
the starter file, floodit_starter.py. Save it ina 
sensible place. 

In the variables section, give the variables 
some values: 


e colours — a list of six colours as strings. These 
can either be common colour names or hex 
colours. The colour names "white", "black", 
"red", "green", "blue", "cyan", "yellow", and 
"magenta" will always be available. 


e board_size — the width/height of the board as an 


integer; we chose 14. The board is always a square. 


e moves limit - how many moves the player 
is allowed before they lose, as an integer; we 
chose 25. 


In the app section, create an App widget and give 
it a title. 


app = App("Flood it") 
app.display() 


Running this will result in a standard labelled 
window (Figure 2). 
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Figure 1 








(IT i@iT | 
Create the board 


The board is a grid of squares, each containing 
a randomly selected colour from the list you 
created earlier. 

Inside the app, add a Waffle widget. This will 
create a grid which will be the board. 


board = Waffle(app) 


Run your program and you will see that the grid is 
a bit too small (Figure 3). 

Add to the line of code you just wrote to specify 
parameters for the width and height of the 
Waffle, and make the padding between the grid 
Squares Zero. 


board = Waffle(app, width=board_ size, 
height=board_size, pad=0) 


That’s better (Figure 4, overleaf). 


Create the palette 
The palette shows the player which colours they 
can click on to flood the board. They will click on 
these colours to play the game. The palette from 
the finished game is shown in Figure 5. 

On the line after you created the board, 
create another Waffle, but this time it should 
be called palette. 





Figure 2 siTelelenit 


A Figure 2 The usual labelled window 


™ The board should start 
off with each square as a 
randomly chosen colour 


palette = Waffle(app) 


Remember when you added the parameters to the 
board Waffle in the previous step? This time, add 
these parameters to the palette Waffle with each 
one separated by a comma: 


width = 6 (the number of colours we have) 
height = 1 
dotty = True (this makes the squares into circles) 


So, now you should have: 


palette = Waffle(app, width=6, height=1, 
dotty=True) 


Run the code to see a blank palette (Figure 6). 


Colour in the board 

The board should start off with each square as a 
randomly chosen colour from the colours list you 
created earlier. On the line below your palette, 
write a call to a function 


fill_board() 


Find the functions section in your program, and 
begin writing the code for this new function: 


def fill _board(): 


You can write a nested loop to loop through every 
row and column in the board. Each pixel will be 
coloured with a randomly chosen colour from the 
list. To colour in a pixel, you will use this code, 
where the ° symbols will be replaced with the x, y 
co-ordinates of the pixel: 


board.set_pixel(?, ?, random. 
choice(colours) ) 


Try to write the code yourself using what you 
have learnt about nested loops in the previous 
instalments in this series — the solution is 
provided below if you get stuck. 


Hint: Use the board_size variable to know how many 
times to loop. 


def fill boa 


When you run your code, you should see a 
colourful board. If you see a white board, 
double-check that you put in the function call to 
fill_board() (Figure 7). 


Here is one solution, but there are many ways 
you could do this: 


def fill_board(): 
for x in range(board_size): 
for y in range(board_ size): 
board.set_pixel(x, y, random. 
choice(colours) ) 


An alternative solution which uses a more 
advanced feature called a list comprehension: 


board.set_pixel(x, y, random. 
choice(colours) ) 


WV Figure 3 The grid squares are too small 
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Graphical User 
Interfaces with 
Python 


For further 
tutorials on how 
to make your own 
GUls with guizero, 
take a look at 

our book, Create 
Graphical User 
Interfaces with 
Python. Its 156 
pages are packed 
with essential info 
and a range of 
exciting projects. 
magpi.cc/ 
pythongui 
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Figure 4 


A Figure 4A grid of the 
correct board size, 
with no padding 


> Figure 6 A blank 
palette 


WV Figure 5 You'll needa 
palette for the player 
to choose a colour 





Colour in the palette 

Now that you have a colourful board, let’s colour 
in the palette. On the line below your fil1_board() 
code, write a call to a function: 


init_palette() 


Find the functions section in your program, and 
begin writing the code for this new function: 


def init_palette(): 


The idea here is to loop through all of the colours 
in the list, assigning one to each of the circles 

in the palette. You can use the same set_pixel 
method as you used for the board to change the 
colour of the circles in the palette. 
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OOOO00O 


Have a go at writing the code yourself. If you get 
stuck, see the ‘How many ways can you colour the 
palette’ box overleaf for some possible solutions. 


Hint: All of the circles in the palette are in row o of 
the Waffle. 


Start the flood 
When the player clicks on a colour in the palette, 
the board should flood with that colour, beginning 
with the top-left square. 

In the functions section, create a new function 
called start_flood in exactly the same way as 
you did for the last two functions. This function 
needs to take two parameters which will be the x, y 
co-ordinates of the square that was clicked on. Add 
these between the brackets so that you end up with 
your code looking like this: 


def start_flood(x, y): 


Add a line of code (indented) to the function to 
obtain the name of the colour that was clicked on: 


flood colour = palette.get_pixel(x,y) 


This will be the colour to flood the board with. 

Now add a line of code to get the current 
colour of the starting pixel — this is always 
the pixel in the top left of the board, at 
co-ordinates 0, O. 


target = board.get_pixel(@,0) 
Now call the flood function, which has already 


been written for you in the starter file. This 
function starts at 0,0 and floods all the pixels 
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Figure 8 Flood it 


connected to the top-left pixel that are the same 
colour with the flood_colour. 


flood(@, 8, target, flood_colour) 


This function should run whenever someone 
clicks on a colour in the palette, so find the line of 
code where you created the palette. 


palette = Waffle(app, width=6, height=1, 
dotty=True) 


Add another parameter, which is a command. 
When a circle on the palette is clicked, this 
command will be executed. The command is the 
function start_flood, so your code should now 





look like this: 
= ‘dth= ; oht= A Fi 8 Here, th 
palette = Waffle(app, width=6, height=1, WM Adda piece of text to the camhtea i 
dotty=True, command=start_flood) is green 


GUI to display whether the 


Test out your code by clicking on the circles on 


the palette. player has won or lost @ 
In our random example (Figure 8), the top-left 
Square is green. If you click purple on the palette, the palette. The aim is to eventually get all of the 
the top-left square will turn purple and connect squares the same colour. 
to the purple square below (Figure 9, overleaf). 
Now there are five purple squares connected to Winning the game 
the top-left square. Let’s click pink to connect up At the moment, if the player manages to get all of 
the pink squares underneath (Figure 10). the squares in the grid the same colour, nothing 
Now there is a large chain of pink squares. happens. The player is also allowed an infinite 
Continue the game by pressing different colours in number of turns, as the number of moves they 


have taken is not tracked. 
: First let’s add a piece of text to the GUI to display 
Figure 7 merereni whether the player has won or lost. The text will 
start off blank. 

Underneath the code for the palette, add a Text 
widget called win_text. 





win_text = Text(app) 


In the variables section, add another variable called 
moves_taken and set it too. 

Now create a function called win_check, which 
will check after each move whether the player 
has won. 

First, you need to specify that you would like 
to be allowed to change the value of the global 
variable moves_taken. 


global moves_taken 


OOOO0OO 


Then add 1 to the moves taken variable — each time 4 Figure 7 Each square 
= of the board is 


this function is called, we will add one more move. coloured randomly 
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A Figure g Clicking 
purple turns it purple 





60 | magpicc | Create GUIs with Python: Flood It 








Vv Figure 10 Click pink 
for a chain of pink 
























































moves_taken += 1 


Check whether the moves_taken is less than the 
moves_limit or not: 


if moves _taken < moves_limit: 
else: 


If the moves_taken is not within the limit, this 
means the playher has run out of moves, so 
update the text to say that they lost: 


if moves _taken < moves_limit: 


else: 
win_text.value = "You lost :(" 


If the number of moves taken is less than the limit, 
check whether all of the squares are the same 
colour by calling the function already written for 
you in the starter file. Make sure the following 
code is indented below the first if statement: 


if all _squares_are_the_same(): 
win_text.value = "You win!" 


The completed piece of code should look like this: 


def win_check(): 
moves_taken += 1 
if moves taken <= moves_limit: 
if all_squares_are _the_same(): 
win_text.value = "You win!" 
else: 
win_text.value = "You lost :(" 


Finally, you must call the win_check function 
whenever a square is clicked on. The easiest way to 
do this is to add the function call at the end of the 
start_flood function. 

Now it’s time to test the game. An example code 
listing is shown in 08-floodit.py. 


Test your game 
You can test whether the game works by playing it; 
however, it might take a long time to test whether 
you can win! An easier way to check is to change 
the board_size variable to something small such as 
5, and then play the game on a much smaller grid 
to see whether you can win. 

You can easily test whether the game causes 
you to lose properly by clicking on the same colour 


aA 
u 


25 times! 7 
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How many ways can you colour the palette? 


Here is a solution which uses a loop and a variable to Here is a different solution which uses the index function 
keep track of which column you are colouring in: colours.index(colour). This code says ‘In the colours list, 
find me the position in the list of colour’. So, for example 
def init_palette(): if your list was ["green", "blue", "red"] then the index 
column = @ of green would be 0, the index of blue would be 1, etc., 
for colour in colours: remembering that we start counting from zero. 
palette.set_pixel(column, @, colour) 
column += 1 def init_palette(): 
for colour in colours: 
Here is a similar solution which uses a range inside the palette.set_pixel(colours.index(colour), @, colour) 


for loop instead of a counter variable: 
You can use any of these solutions, or you may have 


def init_palette(): come up with a different way by yourself. None of them is 
for x in range(len(colours)): the ‘right answer’: there are often many different ways of 
palette.set_pixel(x, @, colours[x]) coding a solution. 









08-floodit.py “i BOMNLOAD 


OOL.. @. 2SSoeSeen esse ees Sees nea s= 046. else: 

002. # Imports 047. return False 

003. rn nnn nnn nnn rrr nner ceeee- e048. 

04. @49. def win_check(): 

e005. from guizero import App, Waffle, Text, PushButton, info eQ5e. global moves_taken 

@06. import random Q@51. moves_taken += 1 

007. Q52. if moves_taken <= moves limit: 

Q08. # ---------------- 20-2 - eee @53. if all_squares_are_the_same(): 
009. # Variables Q54. win_text.value = "You win!" 
O10. ja @2eee Ses sees oe eee reese eee ae @55. else: 

011. 056. win_text.value = "You lost :(" 
@12. colours = ["red", "blue", "green", "yellow", "magenta", Q57. 

@13. “purple” @58. def fill_board(): 

Q@14.  board_size = 14 @59. for x in range(board_size): 

Q@15. moves limit = 25 062. for y in range(board_ size): 
@16. moves_taken = @ 061. board.set pixel(x, y, random.choice(colours) ) 
017. 062. 

Q18.  # ------------------------------ Q@63. def init_palette(): 

Q@19. # Functions e064. for colour in colours: 

Q@20. # -------------- n-ne nnn n-ne ee 65. palette.set_pixel(colours.index(colour), @, 
Q@21. colour) 

@22. # Recursively floods adjacent squares 066. 

@23. def flood(x, y, target, replacement): @67. def start_flood(x, y): 

Q24. # Algorithm from https://en.wikipedia.org/wiki/ 068. flood_colour = palette.get pixel(x,y) 
@25. Flood fill Q69. target = board.get_pixel(@,@) 

Q26. if target == replacement: 070. flood(@, @, target, flood_colour) 
Q@27. return False 71. win_check() 

028. if board.get_pixel(x, y) != target: Q72. 

Q29. return False J 2 

30. board.set_pixel(x, y, replacement) Q74. # App 

Q31. if y+1 <= board_size-1: # South O75. Horn r rr rrr rrr rrr rrr ccc rcerecrree- 

Q32. flood(x, y+1, target, replacement) 076. 

Q@33. if y-1 >= @: # North @77. app = App("Flood it") 

034. flood(x, y-1, target, replacement) 078. 

@35. if x+1 <= board_size-1: # East @79. board = Watffle(app, width=board_size, 
36. flood(x+1, y, target, replacement) height=board_size, pad=@) 

037. if x-1 >= 0: # West Q@80. palette = Waffle(app, width=6, height=1, dotty=True, 
038. flood(x-1, y, target, replacement) command=start_flood) 

Q@39. 81. 

Q@40. # Check whether all squares are the same Q@82. win_text = Text(app) 

Q@41. def all_ squares _are_the_same(): 083. 

Q42. Squares = board.get all() Q84. fill_board() 

043. if all(colour == squares[@] for colour in squares): Q@85. init_palette() 

044. return True 086. 

Q@45. Q@87. app.display() 
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Nik Rawlinson 





Esperanto- 
speaking, pencil- 
wielding, single- 
board computing 
fan who likes 
hyphens and 
remembers what 
that icon on the 
save button depicts. 


nikrawlinson.com 


WV Using third-party 
domain lists simplifies 
the task of adding 
comprehensive sets 
of addresses for 
social networking and 
other services 


Get to grips with 
administering Pi-hole 


Explore the Pi-hole dashboard, learn how to beef up Its 
web filtering features, and use Its integrated DHCP server 


n the last two workshops, we showed you 
how to set up Pi-hole to filter ads and other 
web content on your home network, and 

how to change the DNS settings so you have 
more granular control over the way it works. 

In this final instalment, we’ll be taking a look at 
the broader Pi-hole dashboard, and showing you 
how the changes you make there will allow you 

to control what is — and isn’t — available to other 
computers on your network. We’|] integrate third- 
party domain lists to block distractions with less 
effort, and use Pi-hole’s integrated DHCP server 
to simplify setup on connected clients. 





Log in to Pi-hole 
Although Pi-hole runs on Raspberry Pi, you 
can access the dashboard by pointing a browser 
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towards pi.hole/admin/ on any computer that 
uses Pi-hole to filter its web content. Other 
devices on your network, not filtered by Pi-hole, 
can also access the dashboard by adding ‘/admin/’ 
to the end of the numeric IP address of the Pi-hole 
device. Click Login in the sidebar and provide 

your password. Once you’ve logged in, you’ ll 
notice that the dashboard suddenly becomes a lot 
more informative. It’s worth spending some time 
eetting familiar with its contents. 


Understand your traffic 

The uppermost two graphs depict DNS 
queries passing through Pi-hole. Don’t be 
surprised if there are overnight queries, when 
backup services kick in and some computers 
may be set to update. You can see which of your 
devices is making the most calls at the bottom 
of the page, where their activity is split out into 
total requests and blocked requests. The ‘Queries 
answered by’ panel shows you a count of where 
the answer for each query was sourced from. 


Check what's being blocked 

Unless you disabled logging when you 
installed Pi-hole, it will make a note of every 
request it processes, whether permitted or blocked. 
Browsing the log is a good way to check whether 
anything on your network is attempting to make 
persistent connections to an unauthorised remote 
server, which could suggest it’s hosting malware. 
Click ‘Long-term data’ and, in the section this 
exposes, click Top Lists. Choose a time frame by 


-DietPi- Chro.. FR [pi@pidesk: ~) 


|| & Pthole - DietPi x + 
1é€ 34 


CoA Notsecure | 192.166.150/admir 


Fi-hole 


Total queries (4 clients) 


15,949 


Total queries over last 24 hours 


Pi-hole - DietPi - Chromium 


Queries Blocked 


1,146 
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Fi-hole 


hostname: 


Koemalins on Blocklist 


92,317 


Percent Blocked 


1.2% 


rire 


L320 12:00 13 240 15:00 16:00 1700 1 1b 2000 2100 Te TH O00 O10 02:00 OR OO OS 08 OT 


Client activity over last 


FeVa Veo) ma dal=m pales mUtsy-3 001m Kole is 
are accessed through this 
section of the dashboard 


Query Types 


clicking ‘Click to select date and time range’. 
Start with ‘Last 7 days’ and browse the entries 
in the Top Blocked Domains box. If anything 
looks suspicious, check it using a service like 
Kaspersky’s Threat Intelligence Portal (click 
Lookup at opentip.kaspersky.com). 


Investigate frequent callers 

Should you believe the domain in question 
is a threat, investigate which computer — or 
computers — on your network is making the 
requests to that address. Click Query Log, 
immediately above Top Lists, and isolate the same 
time frame by once again clicking ‘Click to select 
date and time range’. Now type the domain in 
question into the Search box and check the IP 
addresses in the Client column to see which 
computers on your network are insistently 
reaching out to it. Scan the affected computers for 
threats using your regular anti-malware tools. 





Don't be surprised if Pi-hole is showing activity 
when you're asleep. Many computers use this 


MS a (Pv) 
Be AAAA (IPV6) 
serv 

Me S04 

Me rie 








time to update and process cloud backups 


GS dns. google 


Blacklist suspicious domains 
If you’re sure the domain is a threat, you can 


also block access to it through Pi-hole, which will 
stop any malware running on computers filtered 
by your Pi-hole setup from reaching it, potentially 
preventing them from stealing your personal 
data. Simply click Blacklist in the Action column 
against the domain you want to bar. Doing so will 
only affect the specific domain and subdomain 

as specified in the Domain column, but leave 
other subdomains active, so this isn’t the best 
way to block, say, social networking sites, which 
frequently use different domains for browser and 


app access. 


Block complete domains 
So, if you want to use Pi-hole to block 


| You'll Need 


>» Raspberry Pi 


> Pi-hole 
pi-hole.net 


access to complete services, click Blacklist in the 
sidebar and type the last part of the domain name 
into the Domain box. For example, bbc.co.uk, but 
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A Adding a domain 
to the blacklist or 
whitelist and ticking 
the wildcard box will Pi-frole - DietP) - Ghirennum 
apply the same rule to 
all of its subdomains 


Custem disable timeout 
> Use the timeout 


feature to temporarily 
disable Pi-hole. 

This is useful 

when diagnosing 
connectivity issues 
on client devices, or 
for one-off visits to 
blocked sites 


WV Check the status 
box at the bottom of 
the dashboard for 
updates to the Pi-hole 
software, and patch it 
as required 
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not www.bbc.co.uk if you want to block the BBC. 
Now, to block all subdomains within bbc.co.uk, 
including those hosting the website, feeding data 
to apps, serving video and so on, click ‘Add domain 
as wildcard’, then click ‘Add to Blacklist’. In much 
the same way, if any services you need to use are 
being blocked by the third-party filter lists Pi-hole 
uses, you can specifically allow them by clicking 
Whitelist in the sidebar and adding them there. 


07 Bolster your social blocks 

Note that some services use multiple 
domains, which will all need blacklisting if you 
want to lock them out entirely. For example, 
Facebook also hosts data at facebook.net, 
fbcdn.com, fbcdn.net, fobsbx.com, and more. 
Rather than researching every possible domain for 
each social network, you can incorporate third- 
party lists, like those maintained on GitHub at 
magpi.cc/socialblocklists. In Pi-hole, click Group 
Management in the sidebar, followed by Adlists. 
Now paste each pihole-prefixed list into the 
Address box in turn (for example, https://raw. 
githubusercontent.com/gieljnssns/Block_ 
facebook_dns/master/pihole-facebook.txt), 
clicking Add after each one. 





Take a timeout 

If you briefly need to visit a site that’s 
blocked by Pi-hole, or you’ re trying to diagnose 

a problem that you suspect the filter might be 
causing, you can temporarily disengage the whole 
system, rather than trying to work out which 
domains you need to unlock. Click Disable in the 
sidebar, then choose how long you’d like to switch 
off for. The default options are 10 seconds, 30 
seconds, and five minutes, but you can also pause 
filtering indefinitely, or click ‘Custom time’ and 
enter your preferred duration. This exposes every 
device previously filtered using Pi-hole, not only the 
one through which you’re accessing the dashboard. 





Assign network addresses 

So far, we’ve assumed you’re going to 
continue using your router’s DHCP server to assign 
numeric addresses to clients on your network, 
which we’d recommend if you want to use Pi-hole 
on just a few of your devices. However, if you intend 


to use it to filter content for every machine you own, 
it makes sense to also enable its DHCP server. Doing 
so means they’11 automatically use Pi-hole as their 
DNS server, too, which simplifies configuration and 
means any new computers — and devices like voice 
assistants and smart TVs — will be secured as soon 
as they connect to your network. 


DHCP server 

Click Settings, then click the DHCP tab. 
Click the checkbox beside ‘DHCP server enabled’, 
then use the From and To boxes to specify the 
range of addresses that Pi-hole can hand out. 
Unless you have a lot of devices on your network, 
you should be safe to leave the defaults as they 
stand, giving you capacity for 50 devices. Check that 
the address of your router, as specified in the Router 
step below, is correct. If you don’t know what 
your router’s address is, open a Terminal window 
and type: 


ip route | grep default 


The router address appears immediately after ‘via’. 


Disable router-based DHCP 


You shouldn’t have two devices handing 
out IP addresses on your network, so log in to 
your router’s admin pages through the browser 


Pad 0G) Le ee & ere ipo eae. 
G1 02-2 De a fh hp bey pt SF 
Weg 2 Le 1 a hoatphe rp oe 
ed Le 9 A Prete ipod epg. 


a9 2-E Pad 15 a rete Si peer pL. 


™M You shouldn't have two 
devices handing out |P 
gddresses on your network @ 


by typing in the address you obtained using the 

ip route command in the previous step. Navigate 
through its various screens until you find the DHCP 
setting. If this is protected, the administrator 
password is often specified on the back of the 
router itself. Clients on your network will seek out 
a replacement DHCP server automatically and, 
with your router no longer providing this function, 
should find your Pi-hole installation, which will 
assign them the address they require. 


Keep Pi-hole updated 

The status bar at the bottom of every 
dashboard page will warn you if your installation 
is out of date. At the moment, it’s not possible 
to update the system via the graphical interface. 
So, if you spot a red, pulsing ‘Update available!’ 
beside the Pi-hole, web interface or FTL version 
numbers, open a Terminal window on the 
Raspberry Pi running Pi-hole and enter: 


pihole -up 


Pi-hole will check for the latest available version, 
then download and install it automatically. 1] 
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TPi-hole can be 
tweaked and 
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falls over, devices 
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Raspberry P1 Pico 
temperature gauge 


Use your Raspberry Pi Pico's built-in ADC to convert 
Gnalogue Inputs, and read Its internal temperature sensor 
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for open-source 
software and 
hardware, Gareth 
was an early adopter 
of the Raspberry 
Pi platform and 
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You'll Need 


» Raspberry Pi Pico 
» Breadboard 


» LED (any colour) 


> 330 Q resistor 


>» 10kQ 
potentiometer 


>» Male-to-male 
(M2M) jumper wires 





n previous tutorials you’ve been using the 
digital inputs on your Raspberry Pi Pico. A 

digital input is either on or off, a binary state. 
When a push-button switch is pressed, it changes 
a pin from low, off, to high, on; when a passive 
infrared sensor detects motion, it does the same. 

Your Pico can accept another type of input 
signal, though: analogue input. Whereas digital is 
only ever either on or off, an analogue signal can 
be anything from completely off to completely on 
— arange of possible values. Analogue inputs are 
used for everything from volume controls to gas, 
humidity, and temperature sensors — and they 
work through a piece of hardware known as an 
analogue-to-digital converter (ADC). 

In this guide, you’ ll learn how to use the ADC 
on your Pico — and how to tap in to its internal 
temperature sensor to build a data-logging heat 
measurement gadget. You’ll also learn a technique 
for creating an analogue-like output. For this 
you’ll need your Pico; an LED of any colour and 
330 Q resistor; a10kQ potentiometer; anda 
selection of male-to-male (M2M) jumper wires. 
You’ll also need a micro USB cable, and to connect 
your Pico to your Raspberry Pi or other computer 
running the Thonny MicroPython IDE. 


The analogue-to-digital converter 
Raspberry Pi Pico’s RP2040 microcontroller 
is a digital device, like all mainstream 
microcontrollers: it is built up of thousands of 
transistors, tiny switch-like devices which are 
either on or off. As a result, there’s no way for 
your Pico to truly understand an analogue signal — 
one which can be anything on a spectrum between 
fully off and fully on - without relying on an 
additional piece of hardware: the analogue-to- 
digital converter (ADC). 

As the name suggests, an analogue-to-digital 
converter takes an analogue signal and changes 
it to a digital one. You won’t see the ADC on your 
Pico, no matter how closely you look: it’s built 
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into RP2040 itself. Many microcontrollers have 
their own ADCs, just like RP2040, and the ones 
that don’t can use an external ADC connected to 
one or more of their digital inputs. 

An ADC has two key features: its resolution, 
measured in digital bits, and its channels, or how 
many analogue signals it can accept and convert 
at once. The ADC in your Pico has a resolution of 
12 bits, meaning that it can transform an analogue 
signal into a digital signal as a number ranging from 
0 to 4095 — though this is handled in MicroPython 
transformed to a 16-bit number ranging from 0 to 
65,535, so that it behaves the same as the ADC on 
other MicroPython microcontrollers. It has three 
channels brought out to the GPIO pins: GP26, GP27, 
and GP28, which are also known as GP26_ADCo, 
GP27_ADC1, and GP28_ADC2 for analogue channels 
O, 1, and 2. There’s also a fourth ADC channel, 
which is connected to a temperature sensor built 
into RP2040; you’ ll find out more about that later in 
the tutorial. 


™ An ADC takes an analogue 
Signal and changes it to ad 
digital one 


Reading a potentiometer 

Every pin connected to your Pico’s analogue-to- 
digital converter can also be used as a simple digital 
input or output; to use it as an analogue input, you’ Il 
need an analogue signal — and you can easily make 
one with a potentiometer. 

There are various potentiometer types available: 
some, like the ones on the HC-SR501 passive IR 
sensor we used last issue (magpi.cc/106), are 
designed to be adjusted with a screwdriver; others, 
often used for volume controls and other inputs, 
have knobs or sliders. The most common type has a 
small, usually plastic, knob coming out of the top or 
front: this is known as a rotary potentiometer. 


Pick up your potentiometer and turn it over: you’ 1] 
see it has three pins which fit in the breadboard. 
Depending on how you wire these pins up, the 
potentiometer works in two different ways. Start by 
inserting the potentiometer into your breadboard, 
being careful not to bend the pins. Wire the middle 
pin to pin GP26_ADCo on your Pico using a male- 
to-male (M2M) jumper wire, as shown in Figure 1 
— if your Pico is inserted into the breadboard at the 
very top, it’ll be on row 10. Finally, take two more 
jumper wires and wire one of the potentiometer’s 
outer pins — it doesn’t matter which — to your 
breadboard’s power rail and the power rail to your 
Pico’s 3V3 pin. 

Open Thonny and begin a new program: 


import machine 
import utime 


Like the digital general-purpose input/output 
(GPIO) pins, the analogue input pins are handled by 
the machine library — and just like the digital pins, 
they need to be set up before you can use them. 
Continue your program: 


potentiometer = machine.ADC(26) 


This configures pin GP26_ADCo as the first channel, 
ADCo, on the analogue-to-digital converter. To read 
from the pin, set up a loop: 


while True: 
print (potentiometer. read_u16()) 
utime.sleep(2) 


In this loop, reading the value of the pin and 
printing it take place on a single line: this is amore 
compact alternative to reading the value intoa 
variable and then printing the variable, but only 
works if you don’t want to do anything with the 


reading other than print it — which is exactly what 
this program needs at the moment. 

Reading an analogue input is almost identical 
to reading a digital input, except for one thing: 
when reading a digital input you use read(), but 
this analogue input is read with read_u16(). That 
last part, u16, simply warns you that rather than 
receiving a binary 0 or 1 result, you’ ll receive an 
unsigned 16-bit integer — a whole number between 
O and 65,535. 

Click the Run icon and save your program as 
Potentiometer.py. Watch the Shell: you’ll see 
your program print out a large number, likely over 
60,000. Try turning the potentiometer all the 
way in one direction: depending on the direction 
you turned the knob and the outer leg you used 
in your circuit, the number will go up or down. 
Turn it the other way: the value will change in the 
opposite direction. 

No matter which way you turn it, though, it 
will never get anywhere near O. That’s because 
with only two legs connected, the potentiometer 
is acting as a component known as a variable 
resistor or varistor. A varistor is a resistor with 
a value you can change - in the case of a10 kQ, 
potentiometer, between 0Q and10,000Q. The 
higher the resistance, the less voltage from the 
3V3 pin reaches your analogue input — so the 
number goes down. The lower the resistance, the 
more voltage reaches your analogue input — so the 
number goes up. 

A potentiometer works by having a conductive 
strip inside, connected to the two outer pins, 
and a wiper or brush connected to the inner pin 
(Figure 2, overleaf). As you turn the knob, the 
Wiper moves closer to one end of the strip and 
further away from the other. The further the wiper 
gets from the end of the strip you wired to your 
Pico’s 3V3 pin, the higher the resistance; the closer 
it gets, the lower the resistance. 
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WV Figure 2 Howa 
potentiometer works 


Housing 


Resistive element 


Wiper 


3 x electrical terminals 


Varistors are extremely useful components, but 
there’s a drawback: you’ll notice no matter how 
far you turn the knob in either direction, you can 
never get a value of 0 — or anywhere close to it. 
That’s because a10kQ resistor isn’t strong enough 
to drop the 3V3 pin’s output to oV. You could look 
for a bigger potentiometer with a higher maximum 
resistance, or you could simply wire your existing 
potentiometer up as a voltage divider. 


A potentiometer as a voltage divider 
The unused pin on your potentiometer isn’t there 
for show: adding a connection to that pin to your 
circuit completely changes how the potentiometer 
works. Click the Stop icon to stop your program, 
and grab two male-to-male (M2M) jumper 

wires. Use one to connect the unused pin of your 
potentiometer to your breadboard’s ground rail, as 
shown in Figure 3. Take the other and connect the 
eround rail toa GND pin on your Pico. 

Click the Run icon to restart your program. Turn 
the potentiometer knob again, all the way one 
direction then all the way the other. Watch the 
values that are printed to the Shell area: unlike 
before, they’re now going from near-zero to nearly 
a full 65,535 — but why? 

Adding the ground connection to the other end of 
the potentiometer’s conductive strip has created a 
voltage divider: whereas before the potentiometer 


™ You could wire your 
existing potentiometer up 
qs a voltage divider @ 
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was Simply acting as a resistor between the 3V3 

pin and the analogue input pin, it’s now dividing 
the voltage between the 3.3 V output by the 3V3 pin 
and the oV of the GND pin. Turn the knob fully one 
direction, you’ 1] get 100 percent of the 3.3V; turn it 
fully the other way, O percent. 

The number you see printed to the Shell is a 
decimal representation of the raw output of the 
analogue-to-digital converter — but it’s not the 
friendliest way to see it, especially if you forget that 
65,535 means ‘full voltage’. 

There’s an easy way to fix that, though: a simple 
mathematical equation. Go back to your program, 
and add the following above your loop: 


conversion factor = 3.3 / (65535) 


This sets up a mathematical way to convert the 
number that the analogue-to-digital converter 
gives you into a fair approximation of the actual 
voltage it represents. The first number is the 
maximum possible voltage that the pin can expect: 
3.3V, from your Pico’s 3V3 pin; the second number is 
the maximum value the analogue input reading can 
De, 05,535. 

Taken all together, the conversion factor is a 
number created by ‘3.3 divided by 65,535’ — the 
maximum possible voltage divided by the range of 
values the analogue-to-digital converter reports, 
which is in turn a feature of its resolution in bits. 
With your conversion factor set up, you simply need 
to use it in your program. Go back to your loop, and 
edit it to read: 


while True: 
voltage = potentiometer.read ui6() * 
conversion_factor 
print(voltage) 
utime.sleep(2) 


The first line inside the loop takes a reading from 
the potentiometer via the analogue input pin, and 
multiplies it - the * symbol — by the conversion 
factor you set up earlier in the program, storing the 
result as the variable voltage. That variable is then 
printed to the Shell, in place of the raw reading you 
used earlier. 

Your finished program will look like this: 


import machine 
import utime 


potentiometer = machine. ADC(26) 
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conversion factor = 3.3 / (65535) 


while True: 
voltage = potentiometer.read ul6() * 
conversion_factor 
print(voltage) 
utime.sleep(2) 


Click the Run icon. Turn the potentiometer all the 
way in one direction, then the other. Watch the 
numbers being printed to the Shell area: you’ 1l see 
that when the potentiometer is all the way one 
way, the numbers get very close to zero; when it’s 
all the way the other way, they get very close to 3.3. 
These numbers represent the actual voltage being 
read by the pin — and as you turn the knob of the 
potentiometer, you’re dividing the voltage smoothly 
between minimum and maximum, OV to 3.3V. 
Congratulations: you now know how to wire 
a potentiometer as both a varistor and a voltage 
divider, and how to read analogue inputs as botha 
raw value and a voltage! 


Measuring temperatures 
Your Raspberry Pi Pico’s RP2040 microcontroller 
has an internal temperature sensor, which is 
read on the fourth analogue-to-digital converter 
channel. Like the potentiometer, the output of the 
sensor is a variable voltage: as the temperature 
changes, so does the voltage. 

Start a new program, and import the machine and 
utime libraries: 


import machine 
import utime 


Set up the analogue-to-digital converter again, 
but this time rather than using the number of a 
pin, use the channel number connected to the 
temperature sensor: 


Sean @ 
Pt af 





sensor_temp = machine.ADC(4) 


You’ ll need your conversion factor again, to change 
the raw reading from the sensor into a voltage 
value, so add that: 


conversion factor = 3.3 / (65535) 


Then set up a loop to take readings from the 
analogue input, apply the conversion factor, and 
store them in a variable: 


while True: 
reading = sensor_temp.read ui6() * 


conversion_factor 


Rather than print the reading directly, though, you 
need to do a second conversion — to take the voltage 
reported by the analogue-to-digital converter and 
convert it into degrees Celsius: 


temperature = 
@.706)/0.001721 


27 - (reading - 


This is another mathematical equation, and 
one which is specific to the temperature 
sensor in RP2040 . The values are taken from 
a technical document called a data sheet or 
data book: all electronic components have 
a data sheet, which is normally available on 
request from the manufacturer. You can view 
RP2040’s data sheet in the Pico documentation 
at rptl.io/rp2040-get-started — it’s packed 
full of information on how the microcontroller 
works, though it’s aimed at engineers so is 
deeply technical. 

Finally, finish your loop: 


print (temperature) 
utime.sleep(2) 
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<4 Figure 3 Wiring the 
potentiometer as a 
voltage divider 
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Your program will now look like this: 


import machine 
import utime 


sensor_temp = machine. ADC(4) 
conversion factor = 3.3 / (65535) 


while True: 
reading = sensor_temp.read ui6() * 
conversion_factorwhile True: 
temperature = 27 - (reading - 
Q@.706)/0.001721 
print(temperature) 
utime.sleep(2) 


Click the Run icon and Save your program as 
Temperature.py. Watch the Shell area: you’ ll 
see numbers being printed which represent 
the temperature reported by the sensor in 
degrees Celsius. 

Try gently pressing the tip of your finger to 
RP2040, the largest black chip in the middle of 
your Pico, and holding it there: the warmth of 
your finger should make the chip warmer, and the 
temperature will rise. Remove your finger from 
the chip, and the temperature will fall again. 

Congratulations — you’ve turned your Pico into 
a thermometer! 


Fading an LED with PWM 


The analogue-to-digital converter in your Pico only 
works one way: it takes an analogue signal and 
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converts it to a digital signal the microcontroller can 
understand. If you want to go the other way, and 
have your digital microcontroller create an analogue 
output, you’d normally need a digital-to-analogue 
converter (DAC) — but there’s a way to ‘fake’ an 
analogue signal, using something called pulse- 
width modulation or PWM. 

A microcontroller’s digital output can only ever 
be on or off, 0 or 1. Turning a digital output on 
and off is known as a pulse and by altering how 
quickly the pin turns on and off you can change, 
or modulate, the width of these pulses — hence 
‘pulse-width modulation’. 

Every GPIO pin on your Pico is capable of pulse- 
width modulation, but the microcontroller’s pulse- 
width modulation block is made up of eight slices, 
each with two outputs. Look at Figure 4: you’ ll 
see that each pin has a letter and a number in the 
orange labels. The number represents the PWM 
slice connected to that pin; the letter represents 
which output of the slice is used. 


™ There's a way to ‘fake’ 
gn analogue signal, using 
pulse-width modulation @ 


If that sounds confusing, don’t worry: all it 
means is that you need to make sure you keep 
track of the PWM slices and outputs you’re using, 
making sure to only connect to pins with a letter 
and number combination you haven’t already 
used. If you’re using PWM_AI[o] on pin GPo and 
PWM_BI[o] on pin GP1, things will work fine, and 
will continue to work if you add PWM_AI1] on pin 
GP2; if you try to use the PWM channel on pin GPo 
and pin GP16, though, you’d run into problems as 
they’re both connected to PWM_ATo]. 

Take an LED and a 330Q current-limiting 
resistor, and put them in the breadboard as shown 
in Figure 5. Wire the longer leg of the LED, the 
anode, to pin GP15 via the 330Q resistor, and wire 
the shorter leg to the ground pin of your Pico. 

Go back to your first program by clicking on 
its tab just under Thonny’s toolbar; if you’d 
already closed it, click the Open icon and load 
Potentiometer.py from your Pico. Just under where 
you set up the potentiometer as an analogue-to- 
digital input, type: 


led = machine.PWM(machine.Pin(15) ) 
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This creates an LED object on pin GP15, but 
with a difference: it activates the pulse-width 
modulation output on the pin, channel B[7] - 
the second output of the eighth slice, counting 
from zero. 

You’ll also need to set the frequency, one of 
the two values you can change to control, or 
modulate, the pulse width. Add another line 
immediately below reading: 


led. freq(10@0@) 


This sets a frequency of 1000 hertz — one thousand 
cycles per second. Next, go to the bottom of your 
program and delete the print(voltage) and 
utime.sleep(2) lines before adding the following, 
remembering to keep it indented by four spaces so it 
forms part of the nested code within the loop: 


led.duty_u16(potentiometer.read_u16()) 


This line takes a raw reading from the analogue 
input connected to your potentiometer, then uses it 
as the second aspect of pulse-width modulation: the 
duty cycle. The duty cycle controls the pin’s output: 
a O percent duty cycle leaves the pin switched off 
for all 1000 pulses per second, and effectively turns 
the pin off; a100 percent duty cycle leaves the pin 
switched on for all 1000 pulses per second, and is 
functionally equivalent to just turning the pin on as 
a fixed digital output; a50 percent duty cycle has the 
pin on for half the pulses and off for half the pulses. 


To make it so you can properly control the ; 
oe Figure 5 
LED’s brightness, you need to map the value 
from the analogue input to a range the PWM slice A. Figure 5 Adding an LED 


can understand. The best way to do this is to tell 
MicroPython that you’ re passing the duty cycle 
value as an unsigned 16-bit integer, the same 
number format as you receive from your Pico’s 
analogue input pin. This is achieved with the use of 
led.duty_u16. 

Your finished program will look like this: 


import machine 
import utime 


potentiometer = machine. ADC(26) 
led = machine. PWM(machine.Pin(15) ) 
led. freq(10e0e) 


while True: 
led.duty_u16(potentiometer.read_u16()) 


Click the Run icon and try turning the 
potentiometer all the way one way, then all the 
way the other. Watch the LED: this time, unless 
you’re using a logarithmic potentiometer, you’ ll 
see the LED’s brightness change smoothly from 
completely off at one end of the potentiometer 
knob’s limit to fully lit at the other. 

Congratulations: you’ve not only mastered 
analogue inputs, but you can now create the 
equivalent to an analogue output using pulse- 
width modulation! 
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big builds. Legit furniture for your home 
powered by a Raspberry Pi. That’s not the 
only way we define big builds here - they’re builds 
that take time and generally have a lot of parts 
you’re building yourself. 
With that in mind, we decided to put together a 
part two with some smaller big builds. Satisfying, 
yet easy to store. Let’s build. 


ast month we wrote about some truly 
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URL: MAGPI.CC/PIGRRL 


SKILLS: 3D PRINTING, 
SOLDERING/ELECTRONICS 


LEVEL: INTERMEDIATE 









CONSOLE 


Gaming on the go with this small big build 
Prepare a Raspberry Pi 


rcade machines are great, but they 
A don’t really fit in your pocket — we’ve Similarly to a full arcade machine, 


tried. While it may not seem quite as RetroPie really is the best choice for a 


MATERIALS 


- 3D-printed case 
- 2.8 PiTFT Plus 





complex, making yourself a pee aee handheld handheld gaming system. You may need to a elsmerisssch ne: 
still ee a bit of work. Luckily, we have just install extra software for buttons attached over - PowerBoost 1000c 
the build for you. GPIO, and there are details on how to do this - 2500 mAh battery 


on the full guides. - PAM8302 2.5W audio 


Get your parts ae 
- Mini Metal Soeaker 
There are some handy kits you can get on celontcon 
to help build your handheld console (like from WELCOME | erie 
here: magpi.cc/pigrrl), but these only work » Slide switch 
with this specific 3D-printed case. If you’re on Tena slaalaaaca bl aalaa 
Thingiverse looking at different cases, make ROE ere es tactile buttons 
sure to get the right parts. ; Fn - 1x 2 by 20-pin IDC box 


latsxe\e (sla 


Put it 
together 
Once you have all your 
parts and Raspberry 

Pi set up, you can put 
them all together. Be 
careful when placing 
wires So as not to 
block anything, and be 
gentle with any screws 
as some 3D-printed 
plastics may damage if 
you’ re a bit rough with 
a screwdriver. 
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LAPTOP 


Portable computing made 
easy with a tiny computer 












aking a laptop powered by Raspberry Pi is 
remarkable easy. Whether you’re making 
it as small as possible with a Raspberry Pi 
Zero, or taking advantage of a Raspberry Pi 400's 
full set of features, there are many ways to create a 
Raspberry Pi laptop. Here’s one we made in the past: 





M 


Gather your parts 
Get your 3D-printed case and other required 
parts ready. If you’re going for an alternate 
3D-printed case, make sure to get the right parts 
for that specific build. There’s very little wiring 
required here as the keyboard/mouse is wireless, 
and the screen sits on top of the GPIO pins on 
Raspberry Pi. 






















MATERIALS 





Construct the laptop 

Once your Raspberry Pi is ready, you can 
start assembling everything. Even though this 
is an easier build, make sure to be careful with 
wire placement and screws. Give it a test with 
everything in place to make sure you’re happy, 
and then marvel at your tiny build. 





Set up Raspberry Pi 

For easier setup, installing Raspberry Pi OS 

and connecting all the Bluetooth/wireless devices 

and networks before assembling means you 

can fix any issues before any screws are 

tightened. It can also make SD card 

access a lot easier. You’ |] need to 

add the software to run the 
mini display here as well. 
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GALAGA PI 


Get the arcade experience 
without losing space 


e recently wrote about a 3/4-sized 
replica of a Star Wars arcade cabinet, 
which was still pretty big. Galaga Pi, on 
the other hand, will sit nicely on a shelf. Maker 
Tiburcio de la Carcova has made many small, yet 
working, replicas. Here’s how to do it: 





Cut and 

print 
Parts modelled in 
Sketchup (sketchup.com) 
are laser-cut on 3mm 
and 6mm plywood for 
the main frame. Other 
parts are 3D-printed, 
such as the coin slot, 
and there’s acrylic and 
aluminium to complete 
Tiburcio’s requirement. 


- 
= 


. 


ca “ 
































Construct 
Carefully put all 
the parts into the case, 
apply the decals, and 
top with a clear coat for 
a painted look. Close up 
the case and you have 
yourselves a mini arcade 
cabinet ready for Galaga, 
Space Invaders, and 
many other classics. 
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Improvise 
“The joystick 
was a Challenge, since 
there’s no joystick of 
that scale that looked 
accurate,” Tiburcio 
says. “I started with a 
model I found at 
Thingiverse 
(thingiverse.com) and 
improved [it] witha 
metal stick anda 
spring system.” 
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Warning! 7 


CRT monitor 


Be careful working with 
CRT monitors as they 
can hold high levels of 
electrical charge. 


magpi.cc/crt 


URL: 
SKILLS: 


LEVEL: er 
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POLAPI-ZERO 


Bring back instant cameras 
with this tiny yet mighty build 


classic instant camera, it remains 
functionally the same and it’s honestly 
a lot cooler as well. A thermal printer — the kind 
you'd find for printing receipts — prints photos URL: MAGPI.CC/POLAPI 
captured by a Raspberry Pi camera. It even has a 
live view to line up shots. 





W hile this a little different from your easy 


























SKILLS: 3D PRINTING, ELECTRONICS 
LEVEL: INTERMEDIATE 


Print 

This project uses a custom 3D-printed 
camera chassis that works using the exact parts 
listed. It will fit the classic Raspberry Pi Camera 
Module, the buttons, and the screen, as wellasa 
Raspberry Pi Zero to power it all. 





Download and install Assemble 
Ine cream Piette fii itas dome Once you’re SS 
some great programming and image done testing, carefully * Nano Thermal Receipt Printer - TTL Serial 


processing for this build so that the dithering squeeze everything into * Sharp Memory LCD LS027B7DH01A 
- Raspberry Pi Camera Module 


of the black and white pixels looks more the chassis and give it 
' ; ; - 6 x buttons 
CONEIENMOM Ine Timal printed phore, You ll a charge. You’re now 
4 - 3D-printed case 
need to download the code to make it work ready to go out an - 5A 3A voltage regulator 
this well. take some weird and - 2S 72V battery 


wonderful photos. 
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arty the Robot V2 





PROGRAMMING 


LANGUAGES: 
Scratch, Python, 
JavaScript, 

ROS (Robotic 
Operating 
System), OpenAPI 


CONNECTIVITY: 
12C, Bluetooth, 
USB, serial, WiFi 


BATTERY: 

2600 mAh Li-ion 
rechargeable 
battery, 2-3 
hours of use on 
full charge 


SENSORS: 
Accelerometer, 
tilt sensor, 
motor current 
sensors, motion 
position sensing, 
fall detection, 

IR proximity, 
colour & line 
sensor. Optional 
extras: distance 
sensor, noise 
sensor, compass, 
temperature 
sensor 


Inside Marty is a RIC 
(Robot Interface 
Controller) that 

can connect to 
Raspberry Pi via 

a wireless network 


> Robotical » robotical.io » From £377 / S420 


We take this two-legged robot for 
gq walk and wave, By Lucy Hattersley 


arty the Robot V2 is a small, personable 
Vi two-legged robot that uses nine different 

servo motors to move around. It’s capable 
of a wide range of small movements, including 
walking in both directions, rotating, side-stepping, 
kicking, waving, and waggling its eyes. 

All of this movement is controlled by a custom 
RIC (Robot Interface Controller) based upon an 
ESP32 microcontroller (magpi.cc/martytechspecs). 
It has built-in Bluetooth, wireless LAN, an 
accelerometer, and a speaker. It’s powered by a 
rechargeable battery with a built-in USB-C charger. 

With his big blue head and various accessories, 
Marty is a good-looking piece of kit, the sort of 
personable toy that children can make friends 
with. However, there’s a lot to unpack here, 
surprisingly so for a device that looks very much 
at home on the shelf of a local toy store. There is a 
scalable level of complex interaction that can move 
right from key stage 2 (7-year-old and upwards) to 
the university level. 

Right at the entry level, you don’t need any 
computer at all. With an optional IR colour sensor 
(£19, magpi.cc/martycolour), Marty is controlled 
by placing coloured cards on the floor: green to 
move forward, purple to slide right, and so on. 
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The next stage of interaction is via an Android 
or iPhone app. This connects to Marty via 
Bluetooth and provides button controls (walk, 
rotate, and so forth). The app also has a built-in 
version of Scratch 3 that is packed with blocks 
to control Marty. So children can use Scratch to 
create programs for Marty and learn the basics 
of programming with a physical device (much 
more interactive than watching a sprite shuffle 
around the screen). To this end, there area 
range of teacher guides and lesson plans available 
(learn.martytherobot.com). 


Raspberry Pi connection 

The app is also used to connect Marty to a local 
wireless LAN, which is where a Rtaspberry Pi can 
step in. Once on your network, you can move from 


Vv Fitting Raspberry Pi 
inside Marty V2 
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M™ We found Marty personable, fun to play with, and packed 
with features - some of which scale surprisingly high up @ 


Scratch to Python and connect to Marty using connect it to the RIC (magpi.cc/martyraspberrypi) 
the MartyPy library. For example, here was our using the supplied cable. 
program to make Marty dance: Putting a Raspberry Pi inside Marty gives 


it independence from the network and other 
computers or the app. There’s also a decrease in 
latency time, so response time is faster. There’s the 
tantalising possibility to expand Marty’s abilities 
with voice interaction and image processing to make 
There’s a comprehensive Knowledge Base portal on the robot more like a walking smart assistant. 





Robotical’s website (magpi.cc/roboticalknowledge) Even if students never make it that far, learning 
with example code, tutorials, and a Python function code by moving a physical device around, rather than 
reference guide. shuffling sprites around on the screen, is a powerful 

Marty does not - by default - contain a Raspberry concept. And we found Marty personable, fun to play 
Pi computer. Instead, you connect to the built-in with, and packed with features — some of which scale 
RIC (Robot Interface Controller). However, you surprisingly high up. The detailed documentation 
can install a Raspberry Pi inside the head unit and helps get you started and gives you direction. Hl 





Verdict 


A great little robot 
that brings Scratch 
and Python code 
to life. Don't be 
fooled by the cute 
exterior: there's 

a lot of potential 
inside this robot. 


8, 10 
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micro:P1 





FEATURES: 
Buzzer, 

12C Grove 
connectors, 
IR sensor, 

4 x NeoPixel 
RGB LEDs, 
push-buttons, 
OLED screen 


SCREEN 


DETAILS: 
OLED 
0.96°128x64, 
Colours: blue 
and yellow 


> The micro:Pi HAT is 
stacked on top of 
Raspberry Pi 3A+ to 
extend its features ina 
neat and tidy way 





Verdict 


A great starter 

kit with good 
examples that 
could help take 
new and younger 
coders from 
beginners to 
advanced users. 
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> SB Components » magpi.cc/micropi » From £50/$71 


An all-in-one educational kit to teach lot 
built on Raspberry Pi 3A+. By Rob Zwetsloot 


with my Raspberry Pi’ is easier than ever 

these days. However, sometimes there are 
kits you can get that already answer the question 
for you, much like micro:Pi. Like a pi-top or Kano 
product, it builds upon a Raspberry Pi to add 
more features right out of the box. 

In this case, micro:Pi uses a Raspberry Pi 3A+ 

as its base, making use of the smaller footprint of 
the square A+ range. All the extra bits and bobs 
are neatly stacked on top, only increasing its 
vertical size in the process. It has an impressive 
array of components attached as well, including 
lights, IR sensors, buttons, audio in, and a little 
OLED screen to boot. 


A nswering the question of ‘what should I do 


Teachable moment 

Its creator, Dr Anwar Bashir, tells us that a 
number of functions were requested by educators 
— such as a self-test when an internet connection 
is made, and example code discreetly copied to the 
examples folder on each boot. 


M All the extra bits and bobs 
gre neatly stacked on top, 
only increasing its vertical 
size in the process 


These code examples make use of the full range 
of functionality, with programs available to work 
out of the box with the buttons, LEDs, and screen, 
as well as functionality that can easily be added 
via the Grove connectors, such as motors. 

The code is clearly and concisely written in 
Python, although it does make use of a special 
micropi library (similar to GPIO Zero) that will not 
be common elsewhere with Raspberry Pi. 

Still, with all the extra functionality this adds, 
it’s a great beginner kit that can transition to 
doing much more advanced stuff like robotics and 
home automation. Hl 
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10 Amazing 


Displays 


See what you're doing with these 
varied solutions. By Rob Zwetsloot 


ome Raspberry Pi projects don’t need a screen, 
and they’re great. Sometimes, though, having 
something to see is a big part of a project. We 
don’t just mean a standard monitor either: sometimes 
you need something a bit more specialist. Here are some 
ereat options to choose from. Hl 
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41.3 SPI Colour 
Round LCD Breakout 


Your new watch 


A tiny yet vibrant, circular colour display for your smallest 
Raspberry Pi projects, or at least the projects that need a 1.3-inch 
round screen. 


£23 / $33 | magpi.cc/roundlcd 
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4 Official Raspberry Pi 7” 
Touchscreen Display 


A great standard 


The official display is a nice, fairly large screen that is used in many tablet 
projects, especially as it's touchscreen as well It's 800x480 pixels and connects 
to the DSI Display port on Raspberry Pi. 


£60 /S85 | magpi.cc/officialdisplay 


> Inky Impression 


Living paper 


This 5.7-inch, seven-colour e-paper 
display is gorgeous, and perfect for 
projects that don't need a high refresh 
rate or need to look a certain way. 


£66 / $94 
magpi.cc/inkyimpression 





4 HyperPixel 4.0 


High-resolution display 


This 800x480 display is super-reasonably priced, and also comes in a touch 
version. It’s bright and vibrant and honestly one of the best smaller traditional 
screens for Raspberry Pi. 


£39 /S55 | magpi.cc/hyperpixel 


REVIEW | Magri Di 





4 2.23-inch OLED 
display HAT 


Minimalist and sharp 


This small screen is OLED, making it very vivid, but also very 
simplistic, so it’s it perfect for projects that need a basic and 
stylish read out. 





£16/S23 | magpi.cc/oledhat 


4 PITFT Plus 


Classic display HAT >1.54 SPI 
Probably the first big display add-on for Raspberry Pi, the PiTFT is still a great bit Colour Square 
of kit. It has some physical buttons, along with touch sensitivity. |_CD Breakout 


£AT Cie i. itft 
/ $35 | magpi.cc/pi Four awesome sides 


If a round display won't cut it, can 
we tempt you with its more angular 
“ G FX HAT sibling? It’s slightly larger but still 


very small at 1.54 inches. 





Mechanical utility £18/S26 


A different style of display, the GFX magpi.cc/squarelcd 
HAT is a simpler screen that also 
includes nice capacitive touch 
buttons. Perfect for projects that need 
a readout and some interactivity, like 
a thermostat. 


Feo; gos 
magpi.cc/gfxhat 





4 A normal monitor 47° HDMILCD 


You probably have one 


Tablet monitor 
If you want to use Raspberry Pi asa 


desktop computer, there's no better way 
than a standard monitor. Just plug it in 
with an HDMI cable and off you go. 


An alternative to the official display, with higher resolution. It 
connects via HDMI, so it’s a bit of a more traditional monitor, 
although it does have its own case with a kick-stand. 





Prices vary £55/S78 | magpi.cc/hdmiled 
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Learn Linux 
with Raspberry P1 


Get under the hood with the world's most interesting operating system. By Lucy Hattersley 


Work From Home 


Raspberry Fi Blog 


7 





Alasdair Allan Linux is the open-source 

operating system that forms Working from home with your 
Price: the basis of Raspberry Pi OS Raspberry Pi 
Free (which is based on Debian, a nc RACERS Bales 
magpi.cc/ version of Linux). There is a asotsreprcuveararmsigsar eo 
Mate rOnOnenie baffling array of resources for 


learning Linux, but if you really 
want to get to grips with Linux 
and Raspberry Pi, then you 
have to live inside it: turn off 





Windows and macOS. and living with Raspberry Pi as These articles enable you to 
It’s alot like learningasecond yourmaincomputer. Takealook bring Raspberry Pi up to speed 

language: nothing beats the at The MagPi 93 (magpi.cc/93) as your main work computer. 

exposure of living in a place and The MagPi 85 (magpi.cc/85), Spend as much time as you can 

where that’s the only language as well as this fantastic in Linux — and in particular, 

on offer. We’ve written a blog piece by Alasdair Allan: spend as much time in the 

couple of articles about working magpi.cc/workfromhome. command line as possible. 


Linux resources 


Make sure you bookmark these pages 





MAN PAGES to master Linux. Sort by ‘votes’ to see 
Man is the command to enter to some real gems. 

learn more about Linux, and it has its commandlinefu.com 

own man page. Enter man man at the 


command line to read the manual. THE LINUX DOCUMENTATION 





manpages.debian.org PROJECT 

This website is a great resource for 
COMMANDLINEFU.COM any Linux user. Packed with links to 
This user-voted website is a list of guides and how-to tutorials. 
handy commands that you can use tldp.org 
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Debian Reference 


Osamu Aoki 





Price: 
£85 / $110 


magpi.cc/debianref 


ee 


=o 
it 
Le 


oan oie 
ee 0 Pe Cee ee et: La 


‘aan of Gore 


Raspberry Pi OS is based on 
Debian (debian.org),which 

has a fantastic resource that’s 
packed with information about 
Debian and Linux in general. 
You can read it online, and 
install it straight into Raspberry 
Pi OS from the command line: 


see mo eee f Phe de ane 
ag oe een cae ee res me ye gee age ie oad are 
a 


eeoits ode Be on SS ee Pe Loe ry 





sudo apt install debian- 
reference 


After installation, you’ ll find 
Debian Reference sitting under 
the Raspberry Pi Menu > Help 
section. It’1l open in Chromium, 
but you can read the files offline 
in HTML, text, EPUB, or PDF. You 
can also access the files directly 
in /usr/share/debian-reference. 

Debian Reference has a great 
selection of GNU/Linux tutorials 
for the beginner (covering 
console basics and the file 
system). Then it works through 
in-depth package management, 
account authentication, 
networking, and the X Server 
windowing system. 





Gerard 
Beekmans 





Price: 
Free 


magpi.cc/lfs 
magpi.cc/pilfs 


Welcome ta PiLF'S! 


Cepiicmieed fio ei yo boeke yo Geen corgi GAIL 


Learn Linux from Scratch is a 
project that provides step-by- 
step instructions to build your 
own custom Linux system from, 
well, scratch. 

The great thing about this 
approach is that you learn how all 
the different elements are used 
together to form an OS. You cover 
bringing all the main packages 
together, building a file system, 
compiling all the tools, and 
configuring the system to boot. 





This is not a beginner’s guide. 
It is, however, an excellent way 
to get a deeper understanding 
of Linux. 

There is a 350-page book that’s 
now on the tenth version The 
book is designed for AMD/Intel 
CPUs, but you can modify it to 
work with the ARM CPU, and 
PiLFS (magpi.cc/pilfs) has all 
the tweaks you need to build 
your own Linux from Scratch on 
Raspberry Pi. 
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Get some help with 
these courses 


LINUX BASICS AND 
BASH SCRIPTING 
WITH RASPBERRY PI 
This Udemy course walks 
you through Linux witha 
Raspberry Pi and a special 
focus on scripting. 
magpi.cc/linuxbasics 


RASPBERRY PI SOC 
DATASHEETS 

This edX course by 
The Linux Foundation 
is an online affair that 
you work through with 
other students. It's free 
and you can pay extra 
for certification. 
magpi.cc/edxlinux 








THE LINUX 
COMMANDS 
HANDBOOK 

Learn the basics of Linux 
by getting to grips with 
the commands you'll 
actually use. 
magpi.cc/freecodelinux 
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P AlsoaDJ, Alhas 
some radio stations 
under the name 
Impulse Radio 
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A young maker from Andorra with a broad set 
of skills in making and the arts. By Rob Zwetsloot 


> Name AlPemartin — | 


> Community role Contentcreator | 


n a recent Digital 
0) Making at Home stream 
(rpf.io/home), Al dialled 
in from Andorra to talk about 
the stuff they’d been making, 
from robots and video games 
to music and bandanas. What 
started with them watching 


> Occupation Student 


> URL linktr.ee/popito 


their dad write code has 
Spawned into an interest in 
coding and making that has 
resulted in this 13-year-old 
having a presence in several 
online creative communities. 

“T usually just describe myself 
as a ‘content creator’,” Al tells 


Impulse 


IMPULSE 
RADIO 





Feolhonw us 


Lets follow our etation on coclel mais! 
We Foley co Twitter 


Follow os instagram 


Get the app for free 





Announcements 


berpules Updated 


lepuise’s playllss will soon FLAT an 
Godate withenen bepine songs 


us. “But to [be specific], I’m not 
only a music producer, but a DJ, 
a sound engineer, a streamer, 
and I have a radio chain, and 
two stores: one for clothing and 
one for headbands.” 

Al was on the stream for only 
a short time, showing off their 
robot in the process, so we 
decided to catch up with them 
and ask more in the process. 


What do you like to make? 
Essentially anything that has to 
do with computers, whether 
that’s apps, websites, games, 
music, designs... So pretty 
much everything. 


M |'m not only a 
muSIC producer, 
but dg DJ, a 
sound engineer, 
gq streamer @ 





What do you like to stream? 

On my Twitch channel (popito57) 
I mainly stream two things: 
music mixes and video games. 

I don’t really do much else 

there as for me it’s a pretty 
informal platform. 


When did you first learn about 
Raspberry Pi: 

I'd say when I lived in the UK and 
joined the Code Club. I asked 
where the resources came from 
and discovered Raspberry Pi. 


What is the maker community 
like in Andorra? 

I'd mainly say that it focuses 
more on robots and video games, 
since that’s what the main 
academy teaches. 


What’s your favourite thing 
that you’ve made? 

It’s not completely made yet, but 
I'd say one of my projects, ‘The 


Rainbow Mailbox’, which is a 
messaging hotline for any LGBT 
kids that are struggling with 
anything, whether that is in 
school, with family, etc. 


Anything you would like to plug? 
I recently made a Linktree with 
all of my work and social media, 
including things I didn’t/forgot 
to mention in the stream, such 
as my Spotify, so check it out if 
you want to/have the time: 
linktr.ee/popito. H 


THE HEADBAND STAG 


FEATURED PRODUCTS 





Andorra 


Asmall country of nearly 
80,000 people, Andorra lies 
between Spain and France in 
the Pyrenees - the average 
elevation of the country is 
1996 metres, and the capital 
Andorra la Vella is the highest 
capital city in Europe at 1023 
metres! While Catalan is the 
official language, due to its 
size and proximity to France 
and Spain, French and Spanish 
are also commonly spoken, 
along with some Portuguese. 





A We're very partial to the donut masks Al makes here 





INTERVIEW | Mag?hi 



















A Allives in Andorra, a 
small mountainous 
country located 
between France 
and Spain 
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This Month in 


Raspberry 
MagP1 Monday 





Amazing projects direct from our Twitter! 


very Monday we ask the question: have 

you made something with a Raspberry 

Pi over the weekend? Every Monday, our 
followers send us amazing photos and videos of 
the things they’ve made. 

Here’s a selection of some of the awesome 

things we got sent this month — and remember to 
follow along at the hashtag #MagPiMonday! H 





01. We love the idea of this! And pre- 
programmed Nyancat is also great 


02. Aclassic and excellent use of time- 
lapse photography 


03. These drones have been kicking up 
ona storm within the community. They 
look great 


04. PiMowBot continues its progress to 
lawn cutting domination 


05. Asmart-looking time-lapse setup from 
Spencer Organ here 


06. Custom controllers are a great way to 
add something extra to game playing 


07. Amulti-use project that makes the most 
of a small space? We love to see it 


08. The galloping horse is one of the first 
major pieces of animation, and it looks 
great this way 


09. Drifting so hard it will enter the 
D-Dimension 


10. This retro-tastic weather robot, aptly 
named WeatherBot, needs to be a kit 
we think 


11. Curves are tricky. We believe in you, 
though: keep trying 
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My Pico-powered curved HUB7S matrix lamp started 


taking shape 


ItalicShe 
ita! hosaK 


sures kia? 
Replying to i TheMadg! 


Been doing some gardening v& 


ie) Micro Herb Time Lapse filmed on Raspberry Pi Zero using G... 


Filmed wing a Raspberry Pi Zero Wo and Rasoberry Pi Camera 
mounted on a ZeroView and using the Grow Rat Mini, | 


eo” OUD De OT 


(7) electronics monk 


Replying to 


*P|Wings raspberrypipico based multicopter fleet 
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= 
makercupioand 


Enhanced one of the cool summer project from the Replying to @TheMagPi 


latest @MagPi issue 106, My timelapse camera 


zi 


#Make #DIY #3Dprinted #loT #smart #robotics 
Flawnmower based on #RaspberryP! #MagPiMonday 
#MagPiTuesday, 


Here is a PiMowBot community build in action 
@ YouTube 


Mahroboter FitiowBot mn Alton, DIY Robotic Law Mower . 
Ce) Der Rasenmahroboter aus dem 30 Grucker 


@? youtube.com 


= ee Brian Corteil 
Ben be Fcdyires tr Thea 


No long week-end & but great fun building Up a ed i Created an Art 
’ ied - a pated ee 24 So eee Prepared the balcony with a @{lightradaré4 antenna, 
Hmagoimonday *magpituesday =, = : ' i i i 
: " @pimoroni growhat on a @Raspberry_Pi zeroW with Galloping Horse in 256 Pixels 
D Pierre-pres Balache (i/o Ms - rl @esphome i | SENSO, 
OP Qued-ce queron fat pour sa fide qui jou 4 eMinecraft avec un clave FR? auto-watering and a @esphome_ temperature sensor. Eadweard Muybridge study of a galloping horse, 
ae ee cee ee a a ee Ses eee ; ea iP : animated displayed on a @pimoron) Unicom HD hat on 
BS Se eh i ped Bee tor Gaughan ne ply er We eed OR eet - ' 1 ' 


Kad Pelle @ great Qamsie Pel © fa Bored #Pe Phoyeee 


‘a. iv) 4 Raspberry Pi Pid A, 


FTG PIMOoMiay 
Pmagpituesday 


) Or Fowtheg - Roboteer 
Renin hehe] l 


lone eo Talleres de Marquesina 
| made a #2Dprinted drifting tank ir eliactanelt 


erent a 


twitter.cam/driootied, stat 
#MagPiMonday Piet 


= : Still working on that curve! #piwars 
@ 0+ Footieg « Roboteer @crinotieg- May 29 Replying to @TheMagt 
Sn pnriag | created WeatherBot- a Pico Powered Temperature 
Robot that displays the room temperature on his belly 
using a $G90 Servo! | also created a text Adventure 
Game in MicroPython that you can play via the REPL! 
(youtu.be/304¥CIKSSMU) 
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MagPi 


Welcome to your live monitoring 


growlab is a community project to monitor nature with technology 


raat wet thet 


Latest readings 


Reading Value 
Tame 14457 
Tacitus 34.98"C 
Humidity 32.38% 
Predture TA 
here’s a little growing competition going Latest image 


on within the Raspberry Pi community at 

the moment operating under the hashtag 
#erowlab. The brainchild of Alex Ellis, a mainstay 
of the community, it’s a contest to grow seeds as big 
as you can before the UK Harvest Festival, which is 
23 September this year. 

It requires a really simple set of hardware to 
oversee your plants — namely a Raspberry Pianda 
Camera Module. With it, you can track the growth 
using the camera, and you can easily add extra 
sensors to try to help automate the growing. 

“Everyone is welcome to join #growlab,” Alex 
says on the site. “Whether you’re participating in 
the time-lapse contest, or just wanting to connect 
with others and grow your own. You’Il be able to get 
started for under 30 dollars, less if you already own 
a Raspberry Pi and a Camera Module.” 

You can find out more at growlab.dev, which has 
plenty of info on how to get started with both the 
tech and the seeds. 





You can share your setup 
over the web for all to see 


With the right sensors you can track a lot of 
minutiae, perfect for improving your growing 


ga General / BME280 


Ambient Temperature CPU lemperature 
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iP 
1200 16:00) 2000 00:00 400 08:00 3077-05-05 08-74-00 

j . ’ F " ar 20:0 00:00 aU oa 
== [emp.mean (sensor kitchen-growlab} =< temp.mean (sensor mobile} = lemp.mean {sensor kitchengrowlab}): 18.9 "C vs veces 400 28:00 
== (2Mpumenn (fensor: my-she} = temp mean {sensor mobile} §.94 °C wiab} == cpu_temperaiure mean (sensor my-shed)} 


— temp.mean (sensor: my-shed}: 4.08 °C 


Humidity Air Preeeure 
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Thonny Online Collab 





ne of the emails we got this month was from 
a group of students graduating from Calvin lina Create Live Session - Geta : 
University in Michigan, USA. Brad Ritzema, Please provide information needed to start your new CodeLive Session. 
Samuel Zeleke, and Enoch Mwesigwa created a live ¥our ales 
collaboration plug-in for the Thonny Python IDE. It ei rene “ine pendnee 
basically allows you to code with other people. 
MOTT Broker test.mosquitto.org * Built-In 


Their paper addresses the issues with teaching 
industry practices using online learning. “We Please choose the editors you want to share 
; : ; : : <untitied> (Unsaved) 

sought to rectify this problem by introducing a live 

collaboration plug-in titled CodeLive for Thonny. 

[It supports] pair programming where one user (the 
‘driver’ ) writes code while an indeterminate number 
of other users (the ‘navigators’) view their changes. _ | Select All ; == m4 


This takes place while the users converse over an 1 Cancel Start! 
external voice/video channel of their choice.” Hl | 3.9. 8 Library/ Frameworks’ Python, tramework/Versions/3, 9/bin/pythona? 


micro:Pi 


loT HAT & Raspberry Pi 3A+ 


(@ (4 


Building Home Computer 
Robots Automation Programming 
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For more info, please visit: micropi.org 
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Your & 


Letters 


Backwards compatibility 


I bought a Raspberry Pi 1 Model B some years ago from 
Maplins. I would like to buy a book for beginners. Will 
any of the beginner guides still be suitable for this 
older model? 











Colin vid email 


So largely, the code and programs are backwards 
compatible with even that first Raspberry Pi Model B. 
Some stuff may run a little slower, and without the full 40 
pin GPIO you won't be able to attach all available add-ons. 
However, if you're still looking to 
learn to code, work with 
electronics, or maybe 
even set up a media 
centre, you definitely can. 
We recommend our 
Beginner's Guide which 
you can find here: 
magpi.cc/bguide4. 


RP2O040 for all 





I noticed that RP2040 chips are now being sold on their own, so 
I grabbed some for my own experiments. Have other companies 
got these lovely chips and managed to make anything with them 
yet? I’d gladly pay for a souped-up Raspberry Pi Pico. 


Kirsty via Facebook 


There’s been a fair few products released using RP2040, from 
boards that are smaller than a Raspberry Pi Pico like the Tiny 2040 
from Pimoroni (magpi.cc/tiny2040), Arduino Nano 2040 which 
has wireless LAN (magpi.cc/nano2040), and others from Adafruit 
and SparkFun. 

There’s plenty of other types of products, like the Keybow 2040 
from Pimoroni, which you can use as a macro keyboard. Check 
them out! 
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A classic project tor Bes 


pbeny pj makers 


Not so big builds 


I’m not sure quite what I expected but as it turns out, the projects 
in the Big Builds article were a little too big for me. Is there any 
chance that you’d do a slightly larger builds article: Or even a 
normal builds article? 


Jon vid Twitter 
You’re in luck, this issue we have a follow-up to Big Builds called 
Handheld Builds — all part of Feature’s Editor Rob’s Big Build label. 


You can find them starting on page 72, for some great ideas on 
making small things that take a bit of work. 


Contact us! 


> Twitter ©@TheMagPi 


> Facebook magpi.cc/facebook 
> Email magpi@raspberrypi.com 
> Online raspberrypi.org/forums 
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COMPETITION | Magri 


THINE CAMERA 
EXTENSION KITS 


IN ASSOCIATION 
WITH Wiig 









ML 





XN 





This LAN cable extension kit allows 
you to connect a Raspberry Pi 
Camera Module or HQ Camera 
from up to 20m away without any 
quality loss! We reviewed It last 
issue and gave It 9/10, and now 
you can Win one. 





Head here to enter: magpi.cc/win | Learn more: magpi.cc/cableextender 





Terms & Conditions 


Competition opens on 23 June 2021 and closes on 29 July 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
Raspberry Pi Trading (Ltd), the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, 
the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't 
like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be 
contacted by email to arrange delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, 
endorsed or administered by, or associated with, Instagram or Facebook. 
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COMPUTERS 


BRITAIN 


“The Computers that Made Britain 
is one of the best things I've read 
this year. It’s an incredible story of 
eccentrics and oddballs, geniuses and 
madmen, and one that will have you 
pining for a future that could have been. 
It's utterly astonishing!” 
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THAT MADE 


- Stuart Turton, bestselling author 
and journalist 
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Compatibility 


Old Raspberry Pi computers still have a lot of life left in them, 


e had an email this month 
W from a reader who had 
an original Raspberry Pi 


Model B, and was wondering if he 
could still use it. You can read more 
about it on our letters pages (92-93), 
but the short answer is: yes! 

It got me thinking about how | 
use/have used older Raspberry Pi in 
the past. Up until recently, I was using 
a Raspberry Pi 2 as my in-home file 
server with no problems. | still havea 
NES controller that I use for NES 
emulation, that has a pre-production 
Raspberry Pi Zero inside it. [havea 
Raspberry Pi 3 that powers my 
interactive tabletop RPG screen, which 
hopefully I'll be able to use again soon. 


Demystify it 

Due to my position here at The MagP1, 
I do have a wider variety of Raspberry 
Pi boards than most; however, you 
can always grab cheaper/older 
models off eBay, or your auction/ 
local sales website of choice, if you’re 
on a really tight budget. 

This extended lifespan is by design. 
Of course, code is code, so learning 
and using Python naturally works 
across different Raspberry Pi boards. 
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according to Rob Zwetsloot 


However, even the newest Raspberry 
Pi OS is still compatible with original 
Raspberry Pi models. In the past, 
when I’ve spoken with engineers in 
the office, they’ ve pointed out how a 


M Up until recently, 
| was Using d 
Raspberry Pi 2 as my 
in-home file Server 
with no problems @ 


lot of features and functions are 
backwards compatible. Some still 
have an original Raspberry Pi Zero 
powering Kodi ona TV at home. 

It’s clear that power isn’t 
everything. Just look at Raspberry Pi 
Pico — it’s more suited to certain 
projects than even the most powerful 
Raspberry Pi, and it’s much smaller 
to boot. 


Recycling Raspberry Pi 
Using and reusing Raspberry Pi is 
built into its DNA. The amount of 


different little projects I’ve put 
together with the same Raspberry Pi is 
too high to count (on our fingers at 
least), and just because there’s a 
newer Raspberry Pi, it doesn’t mean 
we’ ve stopped using it. I think I’ve 
only broken a single Raspberry Pi, and 
that was an original Model B that gota 
lot of use in the early years from a lot 
of people. The only reason I upgraded 
my file server Raspberry Pi is because 
the Raspberry Pi 2 became a gift for 
my sister, and she still uses it to 

this day. 

Upcycling doesn’t just have to mean 
using hardware from the eighties, and 
recycling doesn’t have to mean 
completely melting down and 
remaking — Raspberry Pi computers 
have a very long lifespan, and can be 
recycled ad infinitum for newer and 
better projects thanks to cross- 
generational compatibility. 


Rob Zwetsloot 





Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 
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e Displays e Cases e Project Kits e Add-on Boards 
e HATs e Arcade eCameras e Cables and Connectors 
e Sensors ® Swag e Power Options e GPIO and Prototyping 


Partner and official reseller for top Pi brands: 
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Buy in Canada: jo] 





BuyaPi.ca/stereopi 





RASPBERRY PI INSIDE 


LinuxGizmos.com MickMake 

“The StereoPi can capture, save, “With it you can do things like, stream 
livestream, and process real-time stereoscopic 3D video to YouTube, build 
stereoscopic video and images for real-time depth maps using OpenCV, 
robotics, AR/VR, computer vision, drone create panoramics using Hugin and even 
instrumentation, and panoramic video.” a 3rd person view of real life. Cool.” 


Elettronica In p- f LinuxGizmos.com @ Geeky Gadgets 


HOW ROBOTS SEE? 


StereoPi is an open source stereoscopic 
camera, based on Raspberry Pi. 


This is the friendliest way to play with 
the stereoscopic vision for the spatially 
aware robots, 3D photo and video! 





Raspbian 


STOCK RASPBIAN 
SUPPORT 


Raspberry Pi Blog 
“There are some excellent 
community efforts too, of 
which our current 
favourite is this nifty dual 


camera board.” 








Hackster News 

“You can hook this up to YouTube, 
to Oculus Go, you can use it with 
OpenCV.. | cannot wait to start 
messing around with these because 
it’s basically a dream come true.” 


OPEMELECTRONICS ft “electronics-lab 


